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1 Installation of the software 
1.1 .Introduction 


For first of all we thank you for your interest in our software product and reading this user's guide. 
This first section of the manual will describe the basic purpose of this software and what hardware 
you will need and may need to you use it. 


The UCCNC is a machine control software. It uses and external hardware to generate signals to 
produce coordinated motion on upto 6 machine axis. The external hardware is a motion controller 
device which is currently our UC100 or UC300 or UC400ETH motion controller. 


This software connects to the external motion controller via a single USB port connection or 
ethernet connection (depends on the motion controller model) of a personal computer (PC) and via 
a software application interface (API) which is built into the software. The installer of the UCCNC 
software includes and completes all the tasks to make it possible to use this software on your 
computer. The device drivers are included in the installer too. 


The UC100 motion controller and this software is not capable to run motors and machine axis 
directly, it is capable only to produce the required signals to run a machine like a CNC mill which 
requires programmed coordinated motions. The possibility and the selection on the external motor 
controller is nearly endless and there are lots of options and choices on the stepper and servo motor 
controller market. We also offering a few options and most of the 3" party hardware available on 
the market today will also work. To get a more clear idea about how this software works and what 
else electronics you may need to get your machine running please read this user's guide further and 
make your own resource on the internet, there are lots of useful informations and articles available 
about motion and motor control electronics. 


1.2 .Safety notes 


Moving objects like machine axis and machine parts can be dangerous and could cause personal 
injury or even death. Please keep this always in mind and operate your machine carefully keeping 
all safety standards and regulations first. 
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1.3 .Hardware requirements 


This software requires Microsoft Windows XP, 7 , 8, 8.1 or 10 Operating System running on an x86 
or x64 desktop or laptop or tablet computer. 


The minimal hardware requirements for the computer are as follows: 
— CPU frequency: minimum 1.8 GHz (duo or dual core is recommended.) 
— Graphics card: OpenGL 1.3 or higher compatible 
— RAM: minimum 1GB for XP and 2GB for all other supported OS. 
— Hard drive space: minimum 16GB 


The above are the recommended minimal values, however the software may run on PCs with lower 
recources, but we do not advice to do so. 

If large G-code files with the hundreds of thousands or millions of code lines count are run then the 
requirements may be higher. 

We suggest to always try the software even in demo mode on the planned to be used computer with 
the largest and most complex planned to be run g-code files to see the performance and to see if the 
computer fits the software requirements. 


1.4 Software prerequirements 


Prior to install the software the .NET framework 2.0 need to be installed. The .net framework 2.0 is 
Microsoft's runtime environment for applications (like the UCCNC) developed in Visual Studio. 


On Windows XP operating system the .net framework 2.0 can be installed from a file which is 
available of Microsoft's website and we also keep a copy of this file on the following link: 


http://cncdrive.com/MC/Software%20prerequirements/dotnetfx2_0.exe 


On Windows 7. the .Net framework 2.0 is part of the Operating system, no need to install it. 


On Windows 8.,8.1 and 10 the .Net framework can't be istalled from file, it can be installed with 
enabling the .Net 3.5 compatibility option in Windows and then it installs automaticly via the 
Windows update. The .Net framework 3.5 package contains the .Net 2.0 package too. 


If the .Net framework is not installed, the UCCNC software installer will not run, it will drop an 
error message on startup and the installer will exit. On Windows 10. no error message will be 
shown, but the installer will not run without the .Net framework 3.5 installed. 


1.5 .Download and install 


The UCCNC software comes in a single .exe executable installer package, the uptodate version is 
always available as a download on our website: 


http://www.cnedrive.com/UCCNC/download_UCCNC.php 
Download the setup.exe file from the above link, save it to your harddrive and double click the file 


to start the installation process. 
When running the setup file the following screen will pop up: 
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i Setup - UCCNC 


Welcome to the UCCNC Setup 
Wizard 
This will install UCCNC version 1.0002 Beta on your computer. 


It is recommended that you close all other applications before 
continuing. 


Click Next to continue, or Cancel to exit Setup. 





Press the next button to proceed the installation. 


i Setup - UCCNC 


License Agreement 
Please read the following important information before continuing. 


Please read the following License Agreement. You must accept the terms of this 
agreement before continuing with the installation. 


End-User License Agreement for UCCNC software 


This End-User License Agreement (EULA) is a legal agreement between you 
(either an individual or a single entity) and the mentioned author (CNCdrive Kft.) 
lof this Software for the software product identified above, which includes 
computer software and may include associated media, printed materials, and 
“online” or electronic documentation (‘SOFTWARE PRODUCT’). 


By installing, copying, or otherwise using the SOFTWARE PRODUCT, you agree to 
be bounded by the terms of this EULA. 

Accepting the EULA you agree that only you will operate this Software and your 
machine tool. 

If you do not agree to the terms of this EULA, do not install or use the 
SOFTWARE PRODUCT. 


SOFTWARE PRODUCT LICENSE 

la.) The UCCNC sofware is being distributed for personal, commercial use. It is 
induded as a downloadable executable file. It may be distributed freely on any 
website or through any other distribution mechanism, as long as no part of it is 
ichanged in any way. 

b.) The Software may need a license key to be installed for the software to 
operate, the license key is not part of the SOFTWARE PRODUCT and may not be 
available for free of charge and it's usage is not covered in this EULA. 


1. GRANT OF LICENSE. This EULA grants you the following rights: Installation and | - 


ima ae unlimited numberof canine of the CORTMIANS 








The End-User License Agreement for the software will appear and you should read the EULA 
carefully and if you agree the terms select the "I accept the agreement" radiobutton and press the 


next key. If you do not accept the EULA then press the cancel button and in this case the installation 
will terminate. 
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i Setup - UCCNC 


Select Destination Location 
Where should UCCNC be installed? 


J Setup will install UCCNC into the following folder. 


To continue, dick Next. If you would like to select a different folder, dick Browse. 
| Browse... | 


At least 32,4 MB of free disk space is required. 








On this screen the installation folder path can be set, The default installation location is your main 
harddrive which is mostly the C: drive and the \UCCNC folder. The path can be changed with 
overwritting the path string on this window. Before pressing the next button make sure that there is 
enough disk space available on the harddrive used for the installation, the required disk space is 
indicated on this window. When these are done press the next button. 


Select Destination Location 
Where should UCCNC be installed? 


( >) The folder: 


P C:\UCCNC 


already exists. Would you like to install to that folder anyway? 








If the software was installed previously to the same directory then the installer will ask for 
permission to overwrite the previously installed software version and the files. 
Select yet to proceed the installation. 
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i Setup - UCCNC 


Select Components 
Which components should be installed? 


Select the components you want to install; clear the components you do not want to 
install, Click Next when you are ready to continue. 











V| Overwrite the default UCCNC profile(recommended) 13 KB 





Current selection requires at least 30,7 MB of disk space. 





| <Back 





There is an option to overwrite or keep the previously installed default profile file. The default 
profile file contains all the settings of the screen, machine settings etc. 
It is strongly recommended to select this option. 


ie Setup - UCCNC 


Select Start Menu Folder 
Where should Setup place the program's shortcuts? 
| ' Setup will create the program's shortcuts in the following Start Menu folder. 


To continue, dick Next. If you would like to select a different folder, dick Browse. 








The installer will ask under what section name to create a shortcut icon for the software in the 
startup menu in Windows. The default is CNCdrive\UCCNC software. Press next to proceed the 
installation. 
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i Setup - UCCNC 


Ready to Install 
Setup is now ready to begin installing UCCNC on your computer. 


Click Install to continue with the installation, or click Back if you want to review or 
change any settings. 


Destination location: 
C:\UCCNC 


Setup type: 
Full installation 


Selected components: 
Overwrite the default UCCNC profile(recommended) 


Start Menu folder: 
CNCdrive\UCCNC software 





Finally before the actual installation process starts a summary screen will appear where you can 
check the settings you made. This is the last time the installation can be rolled back with pressing 
the back button. 

To confirm the settings and start the installation process press next. 


i Setup - UCCNC 
Installing 
Please wait while Setup installs UCCNC on your computer. 
Extracting files... 
C:\Users\CNCdrive \AppData \Local \Temp \is-NAHL2. tmp \installflash.msi 
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Installing 
Please wait while Setup installs UCCNC on your computer. 


> ) Now plug your UC 100 device to the USB port and select the install 
N ! drivers automaticaly if asked. Press the OK button after the drivers 
“—— installation process finished. 





The installation starts and the installer extracting and copying all files and registry entries as 
nessessary. Wait while the process finishes, it may take a few minutes. 

At the end of the installation process you will be asked to plug the UC100 device to the computer's 
USB port, do so. 


Because the USB drivers were preinstalled by the installer Windows will automaticly assign the 
USB drivers to the device once it gets plugged to the PC's USB port. 
Wait while the process finishes and press the next button. 
i= Setup - UCCNC 
Completing the UCCNC Setup 
Wizard 
Q 
Setup has finished installing UCCNC on your computer. The 
application may be launched by selecting the installed icons. 


Click Finish to exit Setup. 


E Run UCCNC.exe 





The installation got finished and selecting the "Run UCCNC.exe" option will start the software 
when pressing the Finish button. Press the finish button to exit the installer. 


1.6 .Licensing. 


The software requires a license key to fully function. The license key is an encrypted file released 
by the author and owner of the software: CNCdrive Kft. company. One license key is valid and can 
be used with one UC100 device only. The license keys are personalised and assigned to an UC100 
or other future motion controller device's serial number which makes the software function with 
that specific device only. 

The UC100 device's serial number and the license key's serial number must match, the license key 
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with one serial number and an UC100 device with a different serial number will not work. 

A separate license key should be purchased for each UC100 devices for the UCCNC software to 
work with them. It also must be noted that the software can connect to and can run with one UC100 
device one time. The license key file is delivered in e-mail only, no physical media (CD/DVD) is 
supplied. 


To install the license key, simply copy the license key file to the UCCNC installation folder and run 
the software. The software automaticaly senses the license key in the installation directory and will 
connect to the device. 


Without a license key the software runs in demo mode when there is no physical connection is made 
to the external motion controller, the software emulates the motion, but signals are not generated by 
the device. 


Without an UC100 device connected or installed to the computer the software will start in demo 
mode. As mentioned previously in this case the software emulates the motion, but no signals are 
generated by the device, all motions happening on the screen is just simulation. 


The possiblity of using the software in demo mode without a software license key and without 
buying an UC100 motion controller provides the ability for you to try and test the software without 
the need of any prior purchase. We recommend that you test and make sure that the software fits 
your needs before purchasing a software license key. 


Software license keys because of the nature of this kind of product are not returnable and are not 
refundable. 

The following printscreen picture shows the software running in demo mode, please note the " 
Running in demo mode..." text in the header of the window. 
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1.7 .The first run, first steps. 


After the installation process and licensing the software it is time to run and setup the software to 
work with your machine. 

To run the software double click the UCCNC icon on the desktop or in the start menu. 

If only a single UC100 or UC300-S5LPT device is connected and if the software is licensed for that 
device then the software will startup. 

If no devices are connected or if more then one devices are connected or if one device is only 
connected but it is not licensed for the software then the following device selection window will 
popup prior to the software startup: 





@ Device selection = [=] 
Select the motion controller device to use from the list: 


Device type: UC100 serial No.:1040A9 


Device type: UC300_5LPT serial No.:236E70 
Device type: Demo_UC100 
Device type: Demo_UC300_5LPT 














Continue 











The device selection window lists all the available motion control devices which are actually 
cunnected to the PC and also it lists the available demo modes to run the software in. The devices 
can be selected with clicking and then with pressing the Continue button the software will startup 
and will connect to the selected device in case that device is licensed. If the selected device is not 
licensed then the software will run in demo mode simulating the selected device. 

Selecting any of the demo modes will also simulate the device. 


1.7.1 .Command line arguments 


Command line arguments can be used to influence how the software starts. 

The arguments may be written to the shortcut icon properties target field after the path of the 
UCCNC.exe file. 

The available command line arguments are as follows: 


— /n: Using this switch in the argument will only allow the software to start one instance. If 
one instance is already running, the software will show an error message and will close. 

— /p profilename : Using this switch forces the software to load a specific machine profile file. 

— /s serialnumber : Using this switch forces the software to connect to a motion controller with 
the specified serial number. If the motion controller is not connected (not available) or if it is 
already in use then the software will show an error message and will close. 


And example for using the command line arguments: 
C:/UCCNC/UCCNC.exe /p myprofile /s 6(0CC4D 


This comamnd will load the myprofile profile file (myprofile.pro) and will connect only to the 
device with the 60CC4D serial number. 
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2 .The graphical user interface 


The graphical user interface (GUI) is based on Flash technology. 

All screen components like the buttons, labels, TAB layers are customisable, the look, format of 
these elements are defined in a screen set script file. The UCCNC software loads the screen set 
script on startup. The name of the screen set file is defined in the Profile file in the 
"mainscreenfilename" key entry. Changing this key entry value will read a different .ssf screenset 
file. The user could write their own screen set file customising the GUI and it's components. 


The screen can be dinamicly resized on the fly and the form elements resizing accordingly, this 
makes the usage ideal on monitors with any screen resolutions. 


2.1 .The default screenset 


The default screenset is the screen set file (.ssf) which the software installs by default. 
This screenset file contains components and graphics for a 6-axis machine controller. 
Printscreens of this screenset are shown in this documentation. 
2.2 .Screen elements 
2.2.1 .Tab pages 


Tab pages are similar to the standard Windows TAB control pages. These elements are like layers 
on the screen. Clicking the label text of the TAB page changes the screen view and showing the 
components on the selected TAB layer. TAB layers can have a hierarchy where any TAB layer can 
have child TAB layers and all TAB layers have a parent layer. The basic layer is layer 1. which is 
the main and lowest layer on the screen, in other words this layer is the UCCNC window itself. 

Any number of tab pages with any labels can be placed onto the screen when making a custom 
screen set file. The way of placing TAB controls on the screen will be further discussed in a 
separate documentation which will be about writing own screen sets. 


The TAB pages on the default screen set are: 

— Run 
This page is the main page of the screen, it contains the buttons to load, edit, run, close a G-code 
file. It also contains buttons to switch the spidle, coolant, mist on/off, select the offset coordinate 
system. It contains a 3D toolpath viewer and a G-code viewer. On the top of the screen the 6 axis 
position DROs and actual and set feedrate, spindle set rotational speed and spindle actual rotational 


speed DROs are taking place. An MDI (manual data input field) is placed on the middle of the 
screen, this component allows a manual G-code input via the keyboard. 


— Toolpath 
This page is to get a more clear view of the toolpath loaded into software. The page contains a large, 
high resolution 3D toolpath viewer and buttons to navigate, zoom and to have different viewing 
angles of the toolpath. 

— Offsets 


This page contains the offset coordinate system parameters. The offset coordinate systems are on 6 
sub TAB pages and are G54, G55, G56, G57, G58, G59 respectively. The actual offset coordinate 
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system can be selected on the Run page. The offset values on the actually selected offset system is 
applied to the coordinate DROs of the machine and the name of the actual offset system is indicated 
in a label on this screen for example "Active fixture: G54" means that the G54 coordinate system is 
selected. Currently work offset is available for all the 6 axis and in addition a tool offset is available 
for the Z-axis. The offset numeric values are one by one all editable on the screen. 
The current position which is the actual position of the machine can be offset with a single button 
press. Also the work offset can be cleared with one button and the tool offset can be cleared in a 
similar way with a single button press. 

— Tools 
This page contains the tool offsets for the Z-axis, because as previously described tool offsets are 
currently only available for the Z-axis only. 
There are in total 20 pieces of tool offsets are available marked Tool#1 to Tool#20 on the screen. 
All tools can have it's own tool length offset value. All tools numberic values are editable on the 
screen and the values can be saved to the profile file. 

— Configuration 
This page is the most complex tab page, it contains several sub TAB pages and this page has all the 
software configuration parameters. The sub tab pages and their purpose will be discussed in the 
followings. 

— Axis setup (sub tab page) 
This page has sub pages for all 6-axis settings X, Y, Z, A, B, C axis respectively. 
The axis settings can be made on these tab pages. 
There is also a sub tab page for the Spindle settings. 

— I/O setup (sub tab page) 


This page contains the input and output pins definitions, settings for the E-stop, charge pump and 
other signals which are not exact relations with the axis and the spindle. 


— General settings (sub tab page) 
This page contains the parameters for the USB communication and some machine behaviour. 
— Appearance (sub tab page) 
This page contains settings for the toolpath viewer screen colors. 
— Importers (sub tab page) 
This page contains data import function(s). 
— Profiles (sub tab page) 
This page contains the machine profile setup, profiles can be loaded, created, deleted. 


— Diagnostics tab page 
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This page shows datas and feedback about the current job and the machine properties, like I/O and 
functions logic states. 


— Help tap page 


This page lists the supported G and M and other codes with basic descriptions. Also the UC100 
device parameters and the license key validity can be read here. 


3.1.1 .Buttons 


Buttons are one of the most important screen elements, these are like Windows buttons, pressing 
them execute an action. All buttons have a function to call inside the UCCNC software. All these 
functions have a pre-defined identify number. When creating a screen set file the buttons can be 
defined to call one of these functions by adding the function number to the button by a parameter. 
The function numbers of the different buttons and how to add them to a custom screen will be 
defined in a separated documentation which will be about writing a custom screen set file. 


To read more about the buttons controls read the Buttons_by_number.htm document. 
3.1.2 .Labels 


Labels are used to show texts on the screen and also they are used to input values from the user. 
Labels can be static labels which are not updateable, their contant is constant and always the same. 
Static labels does not have a reference number since they never need an update of their value, their 
content is static, always the same. The text content of these buttons are defined in the screenset 
script and uploaded to the screen when the software load the screenset. 

There are also output and input type dynamic labels. Dynamic labels are updated by the software 
mostly in sequence or in case an event is happening. Dynamic labels all have a reference/function 
number. There are input and output type dynamic labels. The output type labels are to view only 
text while the input type labels are used to input datas from the user via the screen. 


To read more about the labels controls read the Labels_by_number.htm document. 
3.1.3 .LEDs 


LED controls are used to show the state of Boolean variables states to the user. Leds can have 2 
states on/off and the actual state of each LEDs is updated by the software automaticly. 
Every LED function have a function number which means the variable the LED will indicate. 


To read more about the LED controls read the LEDs_by_number.htm document. 
3.1.4 .Toolpath viewer 


The toolpath viewer is a special control which is used to show, visualise the path the machine will 
execute for the loaded G-code program. Each tab page can have one toolpath viewer control. 
There are several associated buttons functions which can show the toolpath from different view 
points, angles, zoom the contents, zoom in and out etc. To read more about these read the 
Buttons_by_number.htm document and look for the associated buttons controls. 
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3.1.5 Jog control 


The jog control panel is located at the right side of the window and is used to move the machine is 
manual, "jog" mode. 


3.2 .Customising the screen, creating new screensets 
4 Setting up the software for the machine (Configuration) 


4.1 .Axis setup 


The machine axis settings can be configured in the axis setup. 

The axis setup page contains 6 sub tab pages for the 6 available axis. 

All axis has identical settings, except that the X,Y and Z axis can have a slave axis, so these axis 
have an additional setting for the slave axis selection. 


Each axis has the following settings: 

















| @ UCCNC software 
J )FFSETS a CONFIGURATION 
AXIS'SETUP eee] 


Axis enabled 


Step pin: U Active low 


OFFLINE 


Dir pin: Ll Active low MODE 


Enable pin: Active low 


Limit - pin: Active low 


| L Active low 


[1] 

Ez 

={ 0) 

Eq 

Limit + pin: 0. 
1 





Home pin: |} M Activelow LJ Direction positive 


Homing speed up (Units/min): 
SINGLE 


Homing speed down (Units/min): LINE 


Write offset on homing (Units): “| Auto set 
Steps per Unit: 
Velocity (Units/min): 
Acceleration (Units/s^2): 
Softlimit - (Units): 
Softlimit + (Units): 
Comp. Acceleration (Units/s^2): 
Backlash distance (Units): LI Enable backlash 


Slave axis: 








Step port & pin: Which is the physical output pin on the UC100 device for the step signal. The 
signal can be configured active low or active high selecting or unselecting a checkbox next to the 
control. 

The active high means that the rising edge (0->5Volts) is the active edge of the step signal and 
active low means that the falling edge (5->0Volts) is the active edge of the step signal. 


Dir port & pin: Which is the physical output pin on the UC100 device for the step signal. The 
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signal can be configured active low or active high selecting or unselecting a checkbox next to the 
field. Changing the active polarity of the signal reverses the axis running direction. 


Enable port port & pin: Which is the physical output pin on the UC100 or UC300 device for the 
enable signal. Which is the physical output pin on the UC100 device for the step signal. The signal 
can be configured active low or active high selecting or unselecting a checkbox next to the field. 
The enable signal goes active when the axis is enabled with the "Axis enabled" checkbox marked 
and when the software is out of reset. Otherwise the enable signal is inactive. 


Limit — and + port & pins: These are the physical input pins on the UC100 device for the limit 
switches. 

Limit switches are used to limit the workspace, limit the length of an axis or in other words to not 
allow the machine to run over a certain position on each axis direction. 

When the limit switch is activated the UCCNC software triggers the reset signal and stops the 
motion. The signal can be configured active low or active high polarity. The correct polarity 
depends on if the limit switch or sensor inputs a low (OV) or high (5V) signal when activated. 

One negative and one positive side of limit pins can be defined. 

The limit pins may be the same for more than one axis. Any combination of the limit pins for any 
axis is allowed. To disable a limit input pin, write 0 value to the field. 


Home port & pin: Which is the physical input pin on the UC100 device for the Home of Reference 
point switch or sensor. The machine axis can be homed and pick up the reference point using this 
switch or sensor. The signal can be configured active low or active high polarity. The correct 
polarity depends on if the Home switch or sensor inputs a low (OV) or high (5V) signal when 
activated. 

The home direction to the positive or to the negative side of the axis can be configured with the 
"Direction positive" checkbox. 

The home pin may be the same pin as a limit pin, if using the same sensor for the home and limit 
functions. If the home and limit pins are the same then the pin will be treated as a limit pin all the 
time except when a homing sequence for that axis is in execution. In this case the Imit function is 
disabled and the pin is treated as if it was a home switch only. When the homing sequence is 
finished, the pin is again treated as a limit input pin. 


Homing speed up: Which is a numeric value and sets the feedrate of the motion when homing the 
axis and when the axis is moving to the home sensor. 

The Homing feedrate can be equal or lower than the Velocity parameter of the axis. 

The parameter is defined in Units per minute. 


Homing speed down: Which is a numeric value and sets the feedrate of the motion when homing 
the axis and when the axis is moving down from the home sensor. 

The Homing feedrate can be equal or lower than the Velocity parameter of the axis. 

The parameter is defined in Units per minute. 


Write offset on Homing: Which is a numeric value and sets the coordinate to write to the axis 
position DRO when a homing action is executed and succeded. 

The parameter is defined in Units. 

The homing position DRO value can be autoset with checking the checkbox next to the field. 

If the autoset checkbox is not set then the axis will remain it's coordinate when a homing sequence 
is successfully executed. If the autoset checkbox is not set then the set value will be written to the 
axis position DRO when a homing sequence is successfully executed. 


Steps per Units: Which is a numeric value and means the output pulses per one Unit of mechanical 
travel on the machine axis. The correct value depends on the resolution of the motor and motor 
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drive in case a stepper motor and drive is used or on the encoder resolution if a servo motor and 
drive is used to drive the axis. 


Velocity: Which is a numeric value and sets the maximum feedrate on the axis. The axis cannot run 
on higher feedrate then the set value. In GO (rapid linear motion) code execution the motion is 
executed with this feedrate value. 

The value of this parameter is in Units/minute. 


Acceleration: Which is a numeric value and sets the maximum acceleration value of the axis. The 
axis cannot accelerate faster than the set value. 
The value of this parameter is in Units/sec/sec. 


Softlimit - : Which is a numeric value and is the negative direction software position limit. The axis 
cannot run to a lower coordinate than the set value. Note: The software limits can be enabled or 
disabled on the general config tab page with checking or unchecking the enable softlimits 
checkbox. 

The value of this parameter is in Units. 


Softlimit + : Which is a numeric value and is the positive direction software position limit. The axis 
cannot run to a higher coordinate than the set value. Note: The software limits can be enabled or 
disabled on the general config tab page with checking or unchecking the ‘enable softlimits' 
checkbox. 

The value of this parameter is in Units. 


Backlash distance: Which is a numeric value and sets the backlash distance to compensate on the 
axis. The backlash compensation can be enabled or disabled with checking or unchecking the 
‘enable backlash' checkbox next to the textfield. 

The value of this parameter is in Units. 


Compensation acceleration: Which is a numberic value and defines the acceleration of the axis 
when compensating the backlash. This value has to be set at least 20% higher than the acceleration 
parameter of the axis. 

The value of this parameter is in Units/sec/sec. 


Slave axis: This setting is only available for the X, Y and Z axis. These axis can have a slave axis 
attached to them. The slave axis moves together with the master axis. The slave axis can be the A, B 
or the C axis. The slave axis functionality is useful for example in router machines where 2 
separated motors running the same axis on the 2 sides of the gantry axis. These motors can setup as 
a master and slave axis, so the two axis will run together in syncron. 


Calibrate button: Each axis setup page has a calibrate button. Use this button to calibrate the 


resolution (steps per value) on the axis. Pressing this button will open an axis calibration window 
which looks the following: 
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Dir pin: Į Mark the current position ofthe machine axis. Setthe sis 
-| distance and the feedrate on this page and press the OK 
Enable pin: button to make a movement. 
Limit - pin: | 7|Start position(Units): 60 
Limit + pin: | ||Actual steps per Unit: 200 
Home pin: '||Distance to move(Units): 10 positive 
Homing speed up (Units/min): 7|Feed rate(Units/min): 300 — 
Homing speed down (Units/min): 7 SANE = 
Write offset on homing (Units): 4 
Steps per Unit: 4 
Velocity (Units/min): 1 oe i 
Acceleration (Units/s2): 4 
Softlimit - (Units): 4 
Softlimit + (Units): 4 
Comp. Acceleration (Units/s*2): 4 
Backlash distance (Units): 4 
Slave axis: | None Š 

















The calibration is built from a 3 steps sequence. Press the OK button to process the sequences. 

The first step of the sequence moves the axis to the set distance with the set feedrate using the 
currently set steps per unit value. The next step is to measure the distance on the machine axis 
between the movement startpoint and the movement endpoint and type the measured distance value 
back to the screen. In the third seqeunce the software calculates the new steps per value based on 
the previous and the measured input data. The new steps per value is shown on the page and again 
press OK to save the new value and to end the calibration process. 

A new calibration process can be started with pressing the OK button again, or the process can be 
terminated and the window can be closed pressing the cancel button any time. 


4.2 .Spindle setup 


The spindle setup tab page contains settings for the main spindle of the machine. 

The spindle can be a spindle with PWM (analog input) control or a step/dircetion control spindle. 
Separate relays can be also setup to switch the spindle on/off. 

The mist and flood coolant control parameters setup are also located on this tab page, because these 
are in close relation to the spindle control. 


The spindle setup tab page has the following parameters: 
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spain 
AXIS'SETUP osc) |__ W/O TRIGGER | 





Ivi PWM spindle 
PWM pin: 14- port: 1 3) LI Active low 


Dir pin: 0 $ port: 0 +) Li Active low 
PWM frequency (Hz): 900 

PWM min duty (%): |0 

PWM max duty (%): | 100 134 

Index pin: | 0 14} port: | 0 4 

Index prescaler: 16 


Min. spindle velocity (1/min): 10 


[Vi Spindle relay output enabled 
M3 relay pin: 16 -$ port: 1%) Li Active low 


a 


M4 relay pin: 0 port: |0 E U Active low 


M3 delay after on (ms): 1000 
M3 delay after off (ms): 1000 
M4 delay after on (ms): 1000 


POFFSETS A TOOLS Bee Nace eile) L LCAM HELP 


M4 delay after off (ms): 


1000 


Eata- 
( PROFILES 


SPINDLE 


U Step/direction spindle 


a a 


Step pin: 0 -j port: 0 + L Active low 

oa FA Tne i OFFLII 
Dir pin: 0 +) port: 0 +) L Active low eae 
Step per rotation: 500 


Acceleration (step/s%2): 200 
CYCLE 


EFI START 
Encoder PPR: 20 + i à 
Encoder A pin: 0 -$j port: 0 3 
Encoder B pin: | 0 -$j port: 0 3} 


SINGLE 
LINE 
Max. spindle velocity (1/min): 5000 


L Flood/Mist relay outputs enabled FEED 
HOLD 


M7 relay pin: 0 -$j port: 0 +) Li Active low 
M8 relay pin: 0 -j port: 0 44 
M7 delay after on (ms): 1000 
M8 delay after on (ms): 1000 


M9 delay (ms): 0 


LJ Active low 








Settings for a PWM control type spindle: 


PWM spindle check box: Selecting this checkbox sets the spindle to PWM control mode. In PWM 
control the spindle control signal is a PWM (pulse width modulation) signal and the PWM duty 
cycle is changed proportionally with the programmed spindle speed. 

The PWM spindle control mode is useful for analog input spindle electronics forexample for 
Variable Frequncy Drives with analog input. The PWM signal can be filtered, smoothed to an 
analog signal using a simple RC (resistor + capacitor) network. 


PWM port & pin: This is the physical output pin number for the spindle control PWM signal, the 
signal will appear on the selected pin. The signal can be inverted setting the 'active low' checkbox 
next to the textfield. 


Dir port & pin: This is a physical output pin number of the spindle direction signal. The running 
direction of the spindle depends on if an M3 (Clockwise rotation) or M4 (Counter clockwise 
rotation) is programmed. The direction signal changes according to the programmed running 
direction. The signal can be active low or high. Changing the direction active state inverts the signal 
polarity. 


PWM frequency: This parameter sets the base frequency of the PWM signal, in other words it sets 
how long one PWM cycle will last. The time perion of the PWM cycle equals 1/PWM frequency. 


The value of this parameter is in Hertz. 


PWM min duty (%): This parameter sets the minimum duty cycle of the spindle speed PWM 
signal. The PWM duty cycle will go to this level when the lowest spindle speed is set. 
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PWM max duty (%): This parameter sets the maximum duty cycle of the spindle speed PWM 
signal. The PWM duty cycle will go to this level when the highest spindle speed is set. 


Settings for a step/direction control type spindle: 


Step/direction spindle checkbox: Selecting this checkbox sets the spindle to step and direction 
control mode. In step and direction control the spindle control signal is a step pulse train just like it 
is on the machine axis. This control mode is useful for position control spindles like servo motor 
spindles. 


Step port & pin: This is the physical output pin number for the spindle control step signal, the 
signal will appear on the selected pin. The signal can be inverted setting the 'active low' checkbox 
next to the textfield. 


Dir port & pin: This is a physical output pin number of the spindle direction signal. The running 
direction of the spindle depends on if an M3 (Clockwise rotation) or M4 (Counter clockwise 
rotation) is programmed. The direction signal changes according to the programmed running 
direction. The signal can be active low or high. Changing the direction active state inverts the signal 
polarity. 


Steps per rotation: This is a numeric value which represents the number of pulses the controller 
should send out on the step signal to produce one full motor rotation. 


Acceleration: This is a numeric value and sets the maximum acceleration for the spindle. 
The spindle cannot accelerate faster than the set value. 
The value of this parameter is in Rotation/sec/sec. 


The following settings are shared between and valid for both a PWM and step/direction type 
spindle: 


Minimum velocity: This is a numeric value and defines the programmable minimum rotational 
speed for the spindle motor. The spindle can be programmed with the 'S' parameter. If a lower than 
the minimum set value is programmed then the minimum setup value is used. 


Maximum velocity: This is a numeric value and defines the programmable maximum rotational 
speed for the spindle motor. The spindle can be programmed with the 'S' parameter. If a higher than 
the maximum set value is programmed then the maximum setup value is used. 


Index port & pin: This is a physical input pin for the index input signal. The index input signal is 
used to measure the spindle rotational speed and to feed it back to the actual spindle speed DRO. 
The index pin is also the index channel of the spindle feedback encoder for thread cutting. 


Index prescaler: This is a numeric value and is used to divide the frequency of the spindle 
rotational speed. In other words this should be set to a value of 1 if a single slot spindle speed 
sensor is used and a a value of 2 if a dual slot spindle speed sensor is user and so on. 


Encoder PPR: This is a numeric value and defines the pulse per revolution of the incremental 
encoder which is used to feedback the spindle position in sycnronous thread cutting applications. 


Reverse enc.dir: This parameter changes the encoder count direction. If the encoder pins were 
accidentally connected up in reverse then no need to exchange them or to change the A with B pin, 
just change this parameter to change the count direction of the encoder. 
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Encoder A port & pin: This is the physical input pin for the encoder A channel. 
Encoder B port & pin: This is the physical input pin for the encoder B channel. 


Spindle relay outputs enabled checkbox: Selecting this checkbox enables the M3 (rotation CW) 
and M4 (rotation CCW) relay outputs. These output activates when an M3 or an M4 code is 
programmed and the outputs can be used to switch the spindle on/off. Only one of these outputs can 
be active one time. Both outputs can bedeactivated with programming an M5 command. 


M3 spindle relay port & pin: This is a physical output pin for the spindle M3 (CW) relay. The pin 
can be inverted checking the active low checkbox next to the textfield. The pin is active when a M3 
command is programmed and inactive after a M5 command is programmed. 


M4 spindle relay port & pin: This is a physical output pin for the spindle M4 (CCW) relay. The 
pin can be inverted checking the active low checkbox next to the textfield. The pin is active when a 
M4 command is programmed and inactive after a M5 command is programmed. 


M3 delay after on: This is a numeric value. The software dwells for the set amount of time in 
milliseconds when a spindle M3 command is programmed and after the spindle output goes active. 


M3 delay after off: This is a numeric value. The software dwells for the set amount of time in 
milliseconds if the spindle M3 command was active and when a spindle M5 command is 
programmed and after the spindle output goes inactive. 


M4 delay after on: This is a numeric value. The software dwells for the set amount of time in 
milliseconds when a spindle M4 command is programmed and after the spindle output goes active. 


M4 delay after off: This is a numeric value. The software dwells for the set amount of time in 
milliseconds if the spindle M4 command was active and when a spindle M5 command is 
programmed and after the spindle output goes inactive. 


Flood/Mist relay outputs enabled checkbox: Selecting this checkbox enables the M7 (Mist) and 
M8 (Flood) relay outputs. These output activates when an M7 or an M8 code is programmed and 
the outputs can be used to switch the Mist and Flood coolants. Both outputs can be activated the 
same time and both outputs can be deactivated with the M9 command. 


M7 mist relay port & pin: This is a physical output pin for the spindle M7 (Mist) relay. The pin 
can be inverted checking the active low checkbox next to the textfield. The pin is active when a M7 
command is programmed and inactive after a M9 command is programmed. 


M8 flood relay port & pin: This is a physical output pin for the spindle M8 (Flood) relay. The pin 
can be inverted checking the active low checkbox next to the textfield. The pin is active when a M8 


command is programmed and inactive after a M9 command is programmed. 


M7 delay after on: This is a numeric value. The software dwells for the set amount of time in 
milliseconds when a M7 command is programmed and after the Mist output goes active. 


M8 delay after on: This is a numeric value. The software dwells for the set amount of time in 
milliseconds when a M8 command is programmed and after the Flood output goes active. 


M9 delay: This is a numeric value. The software dwells for the set amount of time in milliseconds 
if the M7 and/or the M8 command was active and after these outputs goes inactive. 
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4.3 I/O setup 


The I/O setup tab page contains settings for in and output functions which are not in exact relation 
to the axis. These are the E-stop, probe, index inputs, charge pump, current hi/low output settings. 


The I/O setup tab page has the following parameters for the UC100 device: 


TOOLPATH J OFFSETS J TOOLS Jee Nae ANAON DIAGNOSTICS HELP 
/O TRIGGER GENERAL SETTINGS APPEARANCE PROFILES 


1/0 SETUP 


AXIS SETUP 


E-stop pin: J U Active low 


Probe pin: LI Active low 


G] 
[1&4 
l1] 


Charge p. pin: LI Active low 


a 
\¥| Charge pump always on 


Current hi/low: 0 $} port: 0 $} ™ Active low 


Apply settings 


=) port: 


MPG A pin: p 
port: 


MPG B pin: 

MPG prescaler: 
MPG filter const.: 
MPG speed multiplier: 
LI Attach JRO to MPG 


ivy 
La) 
prs) 


0 - 
0 


àl 


® 


0 
[o] 


Ss 
O 
|3] 
m 





U Enable THC control 


THConpin: 0# 
THC up pin: 
THC down pin: 0 -34 
THC min. height (Units): 
THC max. height (Units): 
THC feedrate (Units/min): 
THC on delay (sec): 


i Control THC even if the 
THC on signal is not active 


port: 
[0 


port: 
port: 


Save settings 


[o0 
lok 
[os 


LU Active low 
Wi Active low 
Wi Active low 
-100 

100 

1000 

0 





The I/O setup tab page has the following parameters for the UC300 device: 


22/67 





@ UCCNC software Sm 
( RUN E TOOLPATH E OFFSETS A TOOLS [ee Ngee? Ngee DIAGNOSTICS JT CAM J HELP] 
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E-stop pin: [11 port: 11 O Activelow MPGApin: 0 $ port: 0 
Probe pin: 12-3 port: 1:4] Li Activelow MPGBpin: |0- port: 0 3} 
Charge p. pin: 16-$}) port: 1 +) LJ Activelow MPG prescaler: 1 B OFFLINE 
vi Charge pump always on MPG filter const.: [ 10 J MODE 
Current hi/low: | 0 -4 port: 0 +) M Active low MPG speed multiplier: 50 
LI Attach JRO to MPG 
Analog input 1 -> var#: o0 ia LI Enable THC control 
Analog input 2 -> var#: |0 THC on pin: [0 port: 0- O Active low 
FRO ana. ch.: 0 min% 0 -jmax% 0 $] THCuppin: 0 +) port: 0 3) M Active low 
SRO ana. ch.: |0 $J min% 0 jmax% 0 J] THCdownpin: 0 $j port: 0 $j M Active low 
JRO ana. ch.: |0 j)min% 0 ‘¢jmax% 0 J] THC min. height (Units): -100 
Var# -> analog out 1: (0 THC max. height (Units): 100 
Var# -> analog out 2: |o ¥ THC feedrate (Units/min): 1000 
Spindle PWM -> analog ch.: [0 THC on delay (sec): 0 


Vi Control THC even if the 
THC on signal is not active 





E-stop port & pin: This is a physical input pin for the e-stop button input signal. The pin can be 
inverted checking the active low checkbox next to the textfield. The machine goes to reset when 
this input signal is active. 


Probe port & pin: This is a physical input pin for the straight probe input signal. The pin can be 
inverted checking the active low checkbox next to the textfield. The straight probe can be 
programmed with a G31 code. 


Charge pump port & pin: This is a physical output pin for the charge pump safety output signal. 
The charge pump safety is a PWM signal. The pin can be inverted checking the active low 
checkbox next to the textfield. The PWM has a fixed 12.50kHz carrier frequency. 

If the 'charge pump always on! checkbox is set then the PWM signal is always on when the UCCNC 
software is running. If the 'charge pump always on" checkbox is not set then the PWM signal is 
only active if the software is not in reset and inactive if in reset. 

The charge pump signal can be used to enable an external electronics only if the UCCNC software 
is loaded or if it is not in reset making the operation of the electronics safe. 


Current high/low port & pin: This is a physical output pin which can be used as an enable signal 
for the external motor control electronics connected to the system. The pin can be inverted checking 
the active low checkbox next to the textfield. The signal is active if the software is running. 


The following parameters are available for the UC300 only, because the UC100 has no analog 
signals: 


Analog input 1-> #var: This setting makes the software to load the analog input 1. channel's read 


value to the internal variable number set in this field. The software continously reading the analog 
input and loading it into the variable. The value of the analog input is represented on 16bits, so the 
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value can be between 0 and 65535, however the analog channel of the UC300's DSP has 12 bits 
resolution only, therefor the read value is multiplied to 16bits and transferred to the software. 

To disable this function write 0 to this field. 

The variables can be used in G-code execution or to read out the value in MDI command: ? 
#variable number. 


Analog input 2-> #var: This setting makes the software to load the analog input 2. channel's read 
value to the internal variable number set in this field. The software continously reading the analog 
input and loading it into the variable. The value of the analog input is represented on 16bits, so the 
value can be between 0 and 65535, however the analog channel of the UC300's DSP has 12 bits 
resolution only, therefor the read value is multiplied to 16bits and transferred to the software. 

To disable this function write 0 to this field. 

The variables can be used in G-code execution or to read out the value in MDI command: ? 
#variable number. 


FRO analog channel: This setting attaches the feedrate override (FRO) to the selected analog input 
channel. Using this function the FRO can be set with an external potentiometer connected to the 
analog input. The min.% value means the FRO percentage, which is set when OVolts applied to the 
analog input and the max.% value sets the maximum FRO percentage, which is when the analog 
input has the maximum 10Volts input Voltage. Setting the min% to 0 value and turning the 
potentiometer down to OVolts sets the feedrate override to 0% which causes a feedhold till the 
potentiometer is turned up again to higher than OVolts. 

Setting the min.% value lower than the max.% value reverses the function, in this case the 10Volts 
input Voltage applies the min% value for the FRO and the OVolts input applies the max.% value. 
This reversible operation makes it possible to use the potentiometer even if it was connected 
backwards to the power supply Voltage. 


SRO analog channel: This setting attaches the spindle rate override (SRO) to the selected analog 
input channel. Using this function the SRO can be set with an external potentiometer connected to 
the analog input. The min.% value means the SRO percentage, which is set when OVolts applied to 
the analog input and the max.% value sets the maximum SRO percentage, which is when the analog 
input has the maximum 10Volts input Voltage. 

Setting the min.% value lower than the max.% value reverses the function, in this case the 10Volts 
input Voltage applies the min% value for the SRO and the OVolts input applies the max.% value. 
This reversible operation makes it possible to use the potentiometer even if it was connected 
backwards to the power supply Voltage. 


JRO analog channel: This setting attaches the jog rate override (JRO) to the selected analog input 
channel. Using this function the JRO can be set with an external potentiometer connected to the 
analog input. The min.% value means the minimum JRO percentage, which is set when OVolts 
applied to the analog input and the max.% value sets the maximum SRO percentage, which is when 
the analog input has the maximum 10Volts input Voltage. 

Setting the min.% value lower than the max.% value reverses the function, in this case the 10Volts 
input Voltage applies the min% value for the SRO and the OVolts input applies the max.% value. 
This reversible operation makes it possible to use the potentiometer even if it was connected 
backwards to the power supply Voltage. 


It is possible to set more than one override function to a single analog channel, for example the 
FRO and SRO can be set to the same channel and then when rotating the potentiometer both the 


feedrate override and the spindle rate override will change. 


It must be noted that when the FRO, SRO or the JRO is attached to an analog input then the screen 
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buttons to adjust the values of these will not function, because then the value is derived from the 
analog input. 


To disable any of these functions set the channel to 0 value. 


Var# — analog output 1. This setting makes the software to load the set variable's value to the 
analog 1. output channel. The valid value ranges are 0 to 65535 (16bits). Writing 0 to the variable 
causes the analog output to be 0 Volts and writing 65535 to the variable will make the analog output 
to go to 10Volts. 

Variables can be programmed in code execution or via MDI command. 

For example to make the variable #1 to get a value of 1000, command #1 = 1000 

To disable this function set the variable number to 0. 


Var# — analog output 2.: This setting makes the software to load the set variable's value to the 
analog 2. output channel. The valid value ranges are 0 to 65535 (16bits). Writing 0 to the variable 
causes the analog output to be 0 Volts and writing 65535 to the variable will make the analog output 
to go to 10Volts. 

Variables can be programmed in code execution or via MDI command. 

For example to make the variable #1 to get a value of 1000, command #1 = 1000 

To disable this function set the variable number to 0. 


Spindle PWM — analog channel.: This setting attaches the PWM spindle control PWM to the 
analog output. The analog output channel will have a value of the spindle PWM duty cycle. 

For example if the minimum PWM is running at 50% duty cycle then the analog channel will have 
a 5Volts output which is the 50% of the 10 Volts maximum. 

It must be noted that this setting overrides the other settings for the analog outputs which means that 
if this function is enabled then other functions cannot write to the selected analog channel. 

To disable any of these functions set the channel to 0 value. 


MPG A port & pin: This is a physical input, the pin of the A input channel of an externally 
connected manual pulse generator (MPG). 
The MPG should produce incremental quadrate A and B channel signals. 


MPG B port & pin: This is a physical input, the pin of the B input channel of an externally 
connected manual pulse generator (MPG). 
The MPG should produce incremental quadrate A and B channel signals. 


MPG prescaler: This is a numeric value and sets the number of encoder ticks when the axis will 
move when the MPG hendwheel is rotated. Setting the value to 1 value will move the axis for every 
encoder ticks. 


MPG filter constant: This is a numeric value and with this setting the smoothness of the axis 
motion for the MPG jog can be set. The higher value means a larger time constant and therefor a 
smoother motion even if the operator hand movement is not smooth, however the larger the value 
the slower the MPG will react. It is adviced to find the optimum where the MPG motion is smooth 
enough and where the reaction time is still not too slow. 


MPG speed multiplier: This is a numeric value and it sets how fast the axis will travel for the 
MPG wheel rotation. Using a higher value will run the machine fast and long for even small 
rotation on the encoder wheel. The optimal value for this parameter depends on several factors, like 
the encoder resolution and the machine type. For metal working machines it is mostly more 
practical to use a low value to let the machine move slower and shorter distances for the MPG 
rotation to let the operator position the machine very precisely. 
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For large scale wood routers it is mostly practical to set this value higher to let the axis move the 
long distances faster. 


4.4 IO trigger 


The IO trigger function contains 3 sub pages which all makes the user interaction with the software 
easier. 


4.4.1 . Input trigger 


The input trigger functionality makes is easy to attach external pushbuttons or switches to call 
internal functions of the software. 

The input port pins can be attached to the UCCNC function numbers. When the input is triggered 
the UCCNC runs the selected function. If the "Low" setting is marked then the input triggers on the 
falling edge (when the input goes from 5Volts to OVolts) otherwise it triggers on the rising edge 
(when the input goes from OVolts to 5Volts) of the signal. All function numbers are listed in the 
documetation subfolder of the UCCNC installation, in the Buttons_by_number.htm document. 

An example is shown on the below printscreen picture, where Pin13. On the Portl. Is attached to 
the 128. function which is the Cycle Start function of the UCCNC software. 

The signal is set active low which means that if the input goes from 5V to OV then the Cycle start 
function is called by the software and if a g-code is loaded then it will start running. 

Calling the 128. function does basicly the same as if the Cycle start button was pressed on the 
screen. 
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4.4.2 .Output trigger 


The output trigger function attaches LED codes to physical output pins of the motion control 


device. The actual logic state of the LED is read and is reflected to the selected output pin. If the 


'low' field is set then the signal gets inverted before the output. 
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4.4.3 Hotkeys 


To Hotkeys function attaches keyboard key triggers to UCCNC function calls. 
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4.5 .General settings 


This tab page contains settings for the machine behaviour. 


The settings available on this page are the following: 
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@ UCCNC software Cote eee) 
(oNN DIA S CA 
TUP O TRIGGER 
Comm. buffer size (sec): 0.1 Kernel frequency: 
Interpolation mode selection: O 25kHz 
O Exact stop mode (O 50kHz OFFLINE 
Constant velocity mode 100kHz Me 
Stop at angle degrees > 89 $ Position DROs digits: 4k 
Look ahead lines count: 300 $ On tool change code (M6) do the following: CYCLE 
Linear error max. 0.03 Ignore tool change code (M6) STARI 
Linear addition lenght max. 1 (O Stop spindle and wait for Cycle Start 
Linear unify lenght max. 2 (O Run the tool change macro (M6) 
Corner error max. 0.03 Safe Z height (Units) 25 
©) Enable softlimits G73 back off (Units) 0.4 
Unknown g-codes: Wignore(_) Warning Don't run (D Measure dwell in seconds instead of msec eam 
Homing sequence: 
1.) |Z axis ~| 2.) |X axis -| 3.) |¥ axis ~ 4.) |\None -| 5.) |None ~ | 6.) |None z CYCLE 
STOP 








Communication buffer size: This parameter sets the length of the USB communication buffer. The 
parameter is in seconds. The shorter the buffer is the faster the machine will react to button presses. 
The minimum set value is 0.05seconds(5O0milliseconds) and the longest is 
0.5seconds(500mseconds). 

Because the motion core of the software is running in a special high priority loop in our testings we 
found that 0.1seconds (100milliseconds) buffer length is enough in all cases and we recommend to 
leave this parameter at this value, but we left the ability to change this setting for the most 
flexibility of the software. 


Interpolation mode selection: This parameter selects how the trajectory planner executes the 
motion. There are two modes, the exact stop mode and the constant velocity mode. 

These two different modes can be also selected executing the G61.1 (exact stop mode) and G64 
(constant velocity mode). When these codes are executed the selection on the screen changes 
accordingly. When a G64 code gets executed the parameters for this command are read from this 
screen Settings. 


Exact stop mode: This is a trajectory planning mode. In this mode the trajectory planner follows 
the motion path positions exactly. The machine axis accelerates at the beginning of each segment 
and deccelerates at the end of each segment. This interpolation mode is adviced to set if close 
tolerance parts are manufactured. The position error is always zero with this interpolation mode. 


Constant velocity mode: This is a trajectory planning mode. In this mode the trajectory planner is 
interpolating to the set feedrate, in other words the trajectory is planned looking ahead in the motion 
path and trying to keep the feedrate constant on the set feedrate. 

For this mode to work some additional parameters needs to be defined which are discussed in the 
followings. The constant velocity mode is adviced to be used when high speed machining is 
nessessary for example 3D artworks are machined. This mode can also be used for close tolerance 
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parts machining, but the tolerance parameters for this mode must be set correctly to force the 
motion planner to not make higher position errors than what is allowed for the workpiece. 

There is always a tradeoff between machining speed and precision. The higher the allowed 
machining errors are set the faster the job will be finished, because the motion planner has more 
space for optimising the motion, however the less the workpiece precision might be. 


Stop at angle degrees: This parameter works only if the Constant velocity mode is selected for the 
mode of interpolation. The parameter is in degrees and means a physical angle. 

When set in constant velocity mode the motion planner looks ahead in the code it will execute 
which means it sees the code it will execute in the near future. The stop angle parameter defines that 
if a higher connection angle on one line segment to the other segment happens then stop the looking 
ahead at that point and only interpolate the previous segments. The looking ahead will start again 
after the point of that too high connection angle. Setting this parameter lower can reduce the 
rounding error on between line segments with high connection angle or in other words on sharp 
edges. 


Look ahead lines count: This parameter works in constant velocity mode only and defines how far 
the motion planner looks ahead in the code, how many line segments in maximum should it 
precheck. Setting the parameter to a high value makes a better constant velocity interpolation 
especially when the motion path is built from short segments and when a long lookahead is 
nessessary to see even a short distance in advance. The higher the look ahead lines are set ofcourse 
the higher the comuputer's CPU and memory usage will be because it takes CPU time and memory 
to look ahead. The default setting is 200 lines which works pretty good in most cases. 


Linear error max.: This parameter sets the maximal linear error for the interpolator and works in 
constant velocity mode only. The higher the parameter is set in most cases the faster the job will 
finish, because the interpolator will shorten the motion path as much as possible with the linear 
error setting. 

The following diagram shows an example path and demomstrates how the linear error checking 
works. The diagram is a simplified view, because at each new point in the path all the previous non 
executed path points are checked. (these are not drawn). 

On the diagram the blue colored path will be a new path and the red colored path shows the path 
where the linear error is higher then the set value, this path gets ignored and the blue path gets 
executed. The linear error calculation is then starts from the point P5 again. 

The parameter is in Units. 








Motion path 


Linear errors 


New path calculated (linear error is below the set value) 


Path with too high linear error (linear error is above the set value) 











Linear addition length: This parameter is in direct conjunction with the "Linear error max." 
parameter and defines the maximal vector length which the interpreter can add to the unified path 
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when the machine is moving in constant velocity mode and when the next line segments fits other 
parameters. This parameter is to limit the position error when interpolating long lines, in other 
words these long lines (which can likely be sides of parts) can be excluded from the look-ahead 
controlled unify process, keeping these lines precise even if the machine is moved in constant 
velocity mode. This parameter has a meaning and work only in constant velocity interpolation 
mode. 


Linear Unify length: This parameter is similar to the "Linear addition length", but it limits the 
length of the unified line segment. In other words the unified vector cannot be longer than defined 
in this parameter. The purpose of this setting is the same as the purpose of the "Linear addition 
length" parameter. This parameter has a meaning and work only in constant velocity interpolation 
mode. 


Corners error max.: This parameter sets the maximal interpolation error at the connection between 
two path points and works in constant velocity mode only. 





P3 
P1 P2 
= Area where the error to the corner is 
lower than the set value. 
«=» The corner error. 











The motion path is calculated in a way that the new faster path contains the error at these 
connection points lower than the set value. In the following graph an example connection and new 
path calculation is demonstrated. The green area is where the corner can be rounded. The machine 
can move anywhere in the green marked area and the fastest possible path will be selected by the 
motion planner. The parameter is in Units. 


Enable softlimits: Setting this checkbox enables the software position limit on all axis. If this 
checkbox is not set then the softlimits are disabled. If the checkbox is set the software limits gets 
enabled and carry the value set on the axis setup page. 


Unknown g-codes: The loaded g-code program may contain g-codes which are unknown, not 
supported by the UCCNC software. This setting allows the user to configure the software what to 
do when any unknown g-codes are found in the g-code program. There are 3 warning levels: 
1.) "Ignore", selecting this mode the software will ignore the unknown g-codes and will run 
without giving any warnings. 
2.) "Warning", selecting this mode the software will give a warning message asking the 
operator what to do, to run the code or not. 
3.) "Don't run", selecting this mode the software will give a warning message and will not 
allow to run the g-code program. 


31/67 


Homing sequence: The order of the homing sewuence can be set here. There are 6 slots where the 
different axis names can be selected. When the Home all command gets executed the axis get 
homed in the order selected here. The first axis in the first slot gets homed first and the axis in the 
sixth slot gets homed last. If not all home slots needed then the value of "none" can be selected then 
those slots will be unused. 


Kernel frequency: The maximum frequency what the UC100 device should output can be defined 
with this setting. The selectable options are 100kHz, 50kHz and 25kHz. 

This parameter defines how many pulses per second the controller should produce. For example 
with the 100kHz setting the maximum steps per second is 100 000 which means a 10microseconds 
total time period for each pulse. With the lower frequencies the signal period is longer which makes 
the setting better suite of drives built with low performance (slow) optocouplers. 


Position DROs digits: This parameter sets the decimal places to show in DROs. The value can be 0 
to 6 decimal places. The numbers shown are then rounded on the screen view, but they are not 
rounded when used for the motion, in other words the numbers rounding only happens on the 
screen. 


On tool change code (M6) do the following: This setting defines how to handle the M6 tool 
change codes. There are 3 options to select from: 

1.) Ignore tool change code(M6) 

Selecting this mode will ignore all M6 codes in the program execution and also if placed into the 
MDI. The M6 codes are simply skipped. This mode should be selected if the machine has no 
automatic toolchanger and if the tool change macro means nothing for the machine. 

2.) Stop spindle and wait for cycle start 

Selecting this mode will stop the motion at any M6 codes and the software will wait for the operator 
to press the Cycle start button. When the Cycle start button got pressed the code execution 
continues. 

3.) Run the tool change macro(m6) 

Selecting this mode will read and execute the M6 macro. The M6 macro is a text file and is located 
in the Profiles\Macro_Name of profile\ folder, where the "Name of profile" is the profile name the 
machine is running. The M6 macro as other macros can contain even complex code to execute a 
complete tool change sequence. For more informations about writing macro codes please read point 
5. in this manual and the Macroing capability _detailed.pdf document. 


Safe Z height: This parameter defines the Z-axis position which is high enough to safely travel of 
the X and Y axis with no risk of a tool collision. This setting is used when the G-code program is 
stopped and the code execution pointer is changed by the user and the "run from here" button was 
pressed. In this case an initial movement is produced moving the machine to safe Z height first and 
moving the machine to the next XY coordinate point. 


32/67 





p 
@ UCCNC software fo |S js} 


UNM | OOLPATH CONFIGURATION HELP 











> 





DIAGNOSTICS 









































ES 60.0000 @) f. 
® 0.0000 ($)jo 
© 0.0000 ($)E 
1 Swi i j OFFLINE 
s I Switch spindle on first 0.0000 a oa 
= Move Z-axis first to safeZ height: 0.0000 L 
up 25 L 
0.0000 an 
% Make movement with safeZ to: 0.0 B 100% START 
se Xass 1 n oa 
ISO Yams: 10 51] [G56] SINGLE 
Yai E CE) Gee) | sna 
PERE 58)) (G59) © P1) P2 
10 X30 R18.75 e 
10 X-10 R20 B axis: 0 ACTIVE FEED 
10 X32,5 R21,25 N HOLD 
10 X-12,5 R22,5 Caxis: 0 G2|G90 
10 X32,5 R22,5 Feed rate: 500.0000 l DWELL 
1 X10 Y10 E: 0 CYCLE 
G1 Z-8 F100 n 
2 Y10 X12,5 R1,25 F5000 m BB 00:0 SIOE 
egos CoN ros Cycle start. 00:00:00 (Ze) 


10 X15 R3,75 
10 X5 R5 ; 
10 X17,5 R6,25 ad at 
10 X2,5 R7,5 L Mr 


10 X20 R8,75 
10 X0 R10 =i Profile:Default 


Cycle start; 

















4.6 .Appearance 


The appearance screen contains settings about the look of the toolpath viewer screen and the G- 
code viewer screen. 
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@ UCCNC software keba- fa] 


P RUN POOL PATH OFFSETS FOOLS ge ie eR DIAGNOSTICS |) PHELP } 
LAXIS SETUP JLO SETUP VO TRIGGER JL GENERAL SETTINGS adele Noi Sia PROFILES 


L Show crosshair on TCP 
L 3D TCP marker 

IV] Show cone icon on TCP 
Undone path color 

Done path color 

Rapid path color 

TCP marker color 


Background color 
Boundaries color 
Interpretable codes color 
Non interpretable codes color il 


Ivi Maximize screen on startup 








The colors of the background, different paths type, tool center point viewer etc. can be set here. 
The following items color can be set: 


Undone path color: This is the color of the toolpath which was yet not executed. 
Done path color: This is the color of the toolpath which was already executed. 
Rapid path color: This is the color of all rapid (GO) movements in the toolpath. 


TCP marker color: This is the tool center point marker's color, which is a cross built from 2 lines 
and the 2 lines connects at the tool-center-point. 


Background color: This is the color of the toolpath viewer's background. 


Boundaries color: This is the color of the toolpath boundary box. 

Interpretable codes color: This is the color of the G and M and other codes which the G-code 
interpreter understands and which codes are executable by the interpreter. 

Non interpretable codes color: This is the color of the G and M and other codes which the G-code 
interpreter does not understand and which codes are not executable by the interpreter. 


3D TCP marker color checkbox: If this checkbox is set then the TCP markers move always at the 
top of the bounderies box and the Z-axis movement is shown with a straight line from the XY point 
to the Z actual height. If this checkbox is unchecked then the TCP markers move always on the 
actual Z height. 


Maximize screen on startup: Setting this checkbox makes the software to start in fullscreen mode. 
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4.7 .Importers 


The importers tab page contains settings import functions. Currently a Mach3 .xml setup file 
importer is available. Pressing the "Import Mach3 XML file" button a file dialog box appears and a 
Mach3 setup file can be imported to the UCCNC software. Loading a Mach3 .xml file imports all 
the settings to the UCCNC Configuration screen. The settings can be applied and/or saved pressing 
the "Apply settings" and "Save settings" buttons. 


4.8 .Profiles 


The profiles tab page contains the setup for the machine profiles. 





@ UCCNC software Faea, 


RUN l OOL PATH OFFSETS JU TOOLS Bee Nee DIAGNOSTICS J CAM AL HELP | 
LAXIS SETUP LO SETUP tO TRIGGER J {APPEARANCE aaa © 





Default 




















New profile name: CEID Mime 
Wi Create shortcut on desktop 





i) a oS 


Each profile can have different machine setup which means that one installation of the UCCNC 
software can be used for more than one machine not simultaneously. The Profile files are located at 
the UCCNC installation folder and the Profiles subfolder, the default file path is 
C:\\UCCNC\Profiles\ , but the installation directory can be different as it is changeable on the 
software installation. 

The Profile files are named as the name of the profile and has a .pro file extension. Each profile is 
stored in a separated file. The .pro files are plain text files with key entries, the files are therefor 
editable manually too with a notepad, but we recommend not to edit it this way, because a mistype 
can cause the key to be unreadable for the software. 

For each profile there is also a folder named Macro_profilename, where the profilename is the name 
of the profile. This folder contains the macro files for that profile. 





On the profiles tab page all profiles can be listed, new keys can be created, already made profiles 
can be deleted and existing keys can be loaded. 
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The following picture shows the profile tab screen: 


Pressing the "list profiles" button lists all of the available profile names in the above listbox. To 
select a profile click the name of the profile in the listbox. 

After selecting a profile clicking the "delete profile" button will delete that profile. Clicking the load 
profile will load that profile. 

To create a new profile put the new profile's name into the textbox left next to the create profile 
button and press the create profile button. If the "Create shortcut on desktop" checkbox was selected 
then a shortcut icon with the profile name will be also created and will be placed on the desktop. 
Double clicking that icon on the desktop will run the UCCNC software loading this profile 
automaticaly. 

After creating a new profile a new .pro file gets created and placed to the UCCNC\Profiles folder. 
Also a new macro folder is getting created with the default macro files inside. 


4.9 .Offsets 


The offsets tab page contains all position offset related settings. 
Currently the work offsets and a tool offset is available. 
The following picture shows the Offsets page: 














@ UCCNC software fo 
( RUN E TOOLPATH Begs TOOLS | YNFIC 
G54 pene) {G56 a n C58 n [G59] 
Offset Table 

Current coords Machine coords Work offset G92 offset Tool offset 
X 60.0000 = 72.5000 |- 12.5000 - 0.0000 
Y 0.0000 = 223.5650 - 223.5650 - 0.0000 
Z 0.0000 = -36.7600 -| -36.7600 |- 0.0000 = 0.0000 
A 0.0000 = 0.0000 = 0.0000 = 0.0000 
B 0.0000 = 0.0000 = 0.0000 = 0.0000 FEED, 
(0) 0.0000 = 0.0000 = 0.0000 = 0.0000 - 


Active fixture: G54 








The offsets page contains 6 sub tab pages, these are the G54, G55, G56, G57, G58 and G59 offset 
pages respectively. These sub tab pages are identical and each of them is a different fixture. 
The fixtures can be selected with programming G54 to G59 in the G-code program or in the MDI. 


There are four columns on each fixture table, the first one is the Current coordinates which is the 
Machine coordinates substracted with the Work offsets. The Machine coordinates which is the 
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absolute coordinate system's actual coordinates, the Work offset coordinates which are separately 
setable for each offset coordinate systems and the Current coordinates are offset with these values. 
The last column is the Tool offset which is the tool length compensation, this value is common for 
all fixtures and currently it is available for the Z-axis only. 


The current position can be offset with a single button press by pressing the "Offset current 
position" button. Pressing this button offsets all the 6 axis with the actual fixture position. 

All offsets can be cleared by pressing the "Clear work offset" button. Clearing the offset will change 
the current coordinates, the cleared offst values are added to the Current coordinates. 


The tool offset can be cleared by pressing the "Clear tool offset" button. Clearing the tool offset 
adds the tool offset to the Current coordinates. 


All the Current coordinates, Work offset and the Tool offset are editable on the screen. 
4.10 .Tools 


The tools page contains a tools table where there are 20 tool slots listed. The different tools length 
can be programmed on the screen. The different tools can be selected programming G43 H"tool 
number" or G44 H"tool number" in program or via the MDI. When programming the G43 or G44, 
the tool length of the selected tool will be offset to the Z-axis. The tool offset can be cleared 
programming G49 in program or via the MDI. 

The following picture shows the Tools page: 




















@ UCCNC software [ic] C=) fs) 
Tools Table 
Tool Z offset (units) Tool Z offset (units) 
Tool #1 3.0000 Tool #11 0.0000 ORELINE 
Tool #2 0.0000 Tool #12 0.0000 
Tool #3 0.0000 Tool #13 0.0000 
Tool #4 0.0000 Tool #14 0.0000 
Tool #5 0.0000 Tool #15 0.0000 RAS 
Tool #6 0.0000 Tool #16 0.0000 
Tool #7 0.0000 Tool #17 0.0000 TE 
Tool #8 0.0000 Tool #18 0.0000 
Tool #9 0.0000 Tool #19 0.0000 
Tool #10 0.0000 Tool #20 0.0000 





4.11 .Diagnostics 
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The diagnostics page contains visual feedback of the inputs and outputs and functions different 
state. The feedback values are shown with virtual LEDs on the screen. 


The LEDs are sectioned into 3 columns, these columns are the following: 


T/O monitor column: This culomn shows one LED for each input and each output pins on the 
UC100 device. The LED states correspond to the logic level of the in and outputs. If the virtual 
LED is grey means that the in or output is low. The input type LEDs are green colored and the 
output type LEDs are red colored when logic high. 


Status monitor column: This cokumn shows the the most important flags in the UC100, there are 
virtual LEDs for the current running status of the controller, the status of the jog, dwell, backlash 
compensation, Homing, probing actions. Also it is showed if the machine is on any hardware limit 
switches and if the limit override function is active. Finally the spindle and the coolant on/off states 
are listed. On the right side of the same culomn the step counter DROs are shown, this counter 
shows the internal step counter values in the UC100 device, these counters have integer values and 
should not be mixed with the position DROs. On the bottom the actual fill of the data buffer is 
shown. 


At the very bottom of this screen the loaded G-code (job) properties are shown. The G-code job 
properties lists the X, Y and Z axis limits, or in other words the minimal and maximal coordinates 
where the machine will move when executing the code. And the size of the part is also shown in the 
X, Y and Z dimensions. The "total objects number" lists the number of the interpreted objects to 
execute in the loaded G-code program. At the bottom the path for the loaded file is listed. 

The following printscreen shows the diagnostics screen when running the software with the UC100: 








@ UCCNC software ba-a-a 
( RUN J (OFFSETS A TOOLS J DIAGNOSTICS (HELP ] 
1/0 monitor I/O function monitor Status monitor 
Port #1 BB X limit + BB X limit - Xpos: 14500 
E oi BB Y limit + BBY limit - Ypos: 44713 
02 BB Z limit + E Z limit - Zpos: -7352 
E o3 BBA limit + BB A limit - Apos: 0 OFFLINE 
E o4 BB limit + BB limit - Bpos: 0 MODE 
E os E C limit + EC limit - Cpos: 0 
E os BB index E x home Buffer:0 
E o7 E Estop BY home H idie 
Os BB Probe BZ home B Run 
Boo I THC enabled E A home Eog 
E 0 E THC on WB home Dwell 
| i WB THC delay E C home I Feed Hold 
E 2 E THC up BE MPG A, B E Home 
E 13 BB THC down Jil Encoder A, B E Probe 
014 BB Spindle CW E Mist BB Reset 
Wiis W Spinde CCW [Flood BB Hard Limit 
016 E Enable X E Enable A BB Limit Override 
017 BB Enable Y Enable B BB Sync. Thread 
BB Enable Z BB Enable C 
Job properties 
Minimum X: - Maximum X: - Size X: - 
Minimum Y: - Maximum Y: - Size Y:- 
Minimum Z: - Maximum Z: - Size Z: - 
Total objects no.: - 
File name: - 











The following printscreen shows the diagnostics screen when running the software with the UC300- 
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SLPT: 














@ UCCNC software Co le pea) 
POFFSETS A TOOLS JU CONFIGURATION MESNE 
1/0 monitor 1/0 function monitor Status monitor 
Port #1 Pot#2 Port#3 Port#4 Port#5 I xX limit + BB X limit - Xpos: 14500 
Moi Boi Boi Boi Boli BY limit+ BB Y limit - Ypos: 44713 
Bie Bo Eo 2 Me E Z limit + H Z limit - Zpos: -7352 
Bis Hos Mos Hs is BA limit + BA limit - Apos: 0 OFFLINE 
Bi Bo Bos 4 E BBiimit+ E B limit - Bpos: 0 MODE 
Bs Wos Mos mi5 Wi WClimit+ EC limit - Cpos: 0 
Bic Wos Mos Mic Mis WB index E x home Buffer:0 
E7 Wor Eo rv V7 I Estop BY home H idie 
Bis Wos Wos Mis Mis E Probe E Z home E Run 
Bis Hoo Woo His M9 I THC enabled E A home E Jog 
Mio Wio Wo Wio Wio THC on E B home Dwell 
Wii Wii Wii Mini Wit THC delay E C home BB Feed Hold 
W2 W2 W12 W2 W2 THC up Ji MPG A, B E Home 
Bis W13 Bus W3 W13 THC down Jil Encoder A, B BB Probe 
M014 Woi Woi Woi M04 Spinde cw H nist Wi Reset — 
Mis W5 W5 W15 W15 WH Spindeccw BB Flood BB Hard Limit HOLD 
Woie Woie FROG Woie Woie PM Enablex BB Enable A BB Limit Override 
W017 M017 Mo7 B017 Wo7 BeEnabley Enable B BB Sync. Thread 
E Enable Z E Enable C Analog 11: 0 
; Analog 12: 0 
Job properties Analog 01:0 
Minimum X: - Maximum X: - Size X: - Analog 02:0 
Minimum Y: - Maximum Y:- Size Y:- 
Minimum Z: - Maximum Z: - Size Z: - 
Total objects no.: - 
File name: - 











4.12 .Porting the settings to a different computer 


It can be sometimes nessessary to copy the settings of the machine or to just port them to a different 
computer. Also it is always a good idea to keep a backup copy of the settings files once the machine 
was setup. In the UCCNC software porting the settings is easy, because all the settings are located 
in an external text file. This text file is located in the UCCNC installation directory /Profiles 
subfolder. The profile file name is always the name of the profile with a .pro extension. For example 
the Default named profile file is named Default.pro. Saving this file saves all of the machine 
settings and copying this file to the same folder on another installation of the UCCNC will copy the 
profile to that computer. 

There are some other important files which are the macro files and these files are compiled and 
called when M (macro) codes are executed. Each profile has it's own macro directory and this 
directory is always named as "Macro_Name of profile" where the "Name of profile" is the profile's 
name. This folder also needs to be ported if macro macro calls will be used. 


To make the profile ported installation complete and easy to use for the user a shortcut icon can be 
created to load the profile directly when double clicked on the Windows desktop or an old shortcut 
icon can be copied and edited. To let the shortcut icon load the UCCNC software, edit it's properties 
and set the target value to point the UCCNC .exe file's location which is by default the 
C:\UCCNC\UCCNC.exe, however the path may be different, because it can be changed at the 
software installation. Also set the /p switch for the shortcut icon and write in the name of the profile 
which the shortcut has to load when clicked. In summary, the shortcut icon's target icon to load the 
profile named testprofile! should look the following: C:\UCCNC\UCCNC.exe /p testprofile 


When double clicking the shortcut icon it runs the UCCNC.exe software and will pass the /p 
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parameter with the "testprofile" value which will force the UCCNC software to load the profile 
named testprofile. 


5 .The code interpreter 


The code interpreter can read the G-code program when opened from file and also it can read G- 
code commands if entered into the MDI. The interpreter first reads the code then compiles it to and 
internal structure list which it can execute as movements, I/O manipulations or whatever the code 
has to do when executed. 


When the code is loaded from a G-code file the interpreter marks the codes it understood and which 
it can execute with a different color than the codes it cannot understand and can't execute. 

This colored code text is shown in the g-code viewer control on the screen. 

In default the codes which can be executed are marked with a white color and the ones which the 
interpreter can't understand and are not executable are marked with a red color by default, but these 
colors are configurable on the appearance settings page. 


5.1 Supported codes 


The supported codes are the codes which the code interpreter understands and which it can execute. 
In the following sections these codes are listed with some descriptions. 

When developing we followed the industry standard RS274 format and used the same codes which 
codes this standard implements. 


5.1.1 .G-codes 


In this section of the documentation the currently supported G-codes are listed, these are the codes 
which the code interpreter understands. The list of the supported G-codes will change, we planned 
to add support for more codes in the future, but the currently supported codes already covers the 
needs of the avarage machining jobs. 


The supported G-codes are the following: 
Rapid Linear Motion : GO 


For rapid linear motion, program GO X... Y... Z... A... B... C..., where all the axis words are 
optional. The GO is optional if the current motion mode is GO. 

If absolute distance mode is selected (G90) then this command will produce coordinated linear 
motion to the destination point at the maximal possible feed rate. 

If relative distance mode is selected (G91) then this command will produce coordinated linear 
motion to the current point plus the programmed point coordinates. In other words the new point 
will be an increment on the current point. 

It is expected that cutting will not take place when a GO command is executing. 

If all axis words are ommited then no motion will happen, but the active motion mode changes to 
GO. The axis coordinates 


Linear Motion at Feed Rate : G1 
For linear motion at feed rate (for cutting or not), program G1 X... Y... Z... A... B... C..., 
where all the axis words are optional. The G1 is optional if the current motion mode is G1. 


If absolute distance mode is selected (G90) then this command will produce coordinated linear 
motion with the programmed feedrate to the destination point at the maximal possible feed rate. 
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If relative distance mode is selected (G91) then this command will produce coordinated linear 
motion with the programmed feedrate to the current point plus the programmed point coordinates. 
In other words the new point will be an increment on the current point. 

If all axis words are ommited then no motion will happen, but the active motion mode changes to 
Gl. 

Arc at Feed Rate : G2 and G3 


A circular or helical arc is specified using either G2 (clockwise arc) or G3 (counterclockwise arc). 


— The arc lies on the XY plane if the G17 plane is in selection. 
— The arc lies on the XZ plane if the G18 plane is in selection. 
— The arc lies on the YZ plane if the G19 plane is in selection. 


A 3rd axis offset can be also programmed, in this case the 3rd axis will do a linear motion and will 
start to move the programmed distance when the arc interpolation starts and finishes the movement 
when the arc interpolation ends. If the 3rd axis offset is programmed then the path will be a helix 
instead of an arc. 

There are two ways to define the arc, one way is the center mode and the other is the radius mode. 
In the center mode the I and J and K parameters defines the center of the circle. 

In the radius mode the R parameter defines the radius of the circle. 


To interpolate an arc or helix in the center format, program G2 (or G3) X... Y... Z... L.. J... Ka., 
where X and Y and Z are the endpoint coordinates and 

— ifthe G17 plane is selected then I and J specifies the center of the arc. 

— ifthe G18 plane is selected then I and K specifies the center of the arc. 

— ifthe G19 plane is selected then J and K specifies the center of the arc. 


To interpolate an arc or helix in the radius format, program G2 (or G3) X... Y... Z... R... , where X 
and Y and Z are the endpoint coordinates of the arc and R specifies the radius of the arc. A positive 
radius indicates that the arc turns through 180 degrees or less, while a negative radius indicates a 
turn of 180 degrees to less than 360 degrees. 


In both formats the axis coordinates mean the endpoint of the arc or helix if the absolute distance 
mode is selected (G90). And in relative distance mode the endpoint is the current point plus the 


programmed coordinates. 


The following image shows the directions of the arcs on the different planes: 
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Dwell : G4 


For a dwell, program G4 P.... This will keep the axes unmoving for the period of time in 
milliseconds. specified by the P number. 

It is an error if: 

e the P number is negative. 


Set tool lengt in tool table: G10 L1 


To set the tool length value program G10 L1 P ... Z ..., where the where the P number must 
evaluate to an integer in the range 1 to 20 (corresponding to tool number 1 to 20.) 

The programmed Z parameter will be the tool length for programmed tool. 

The tool length data is uploaded to the Tools table screen of the UCCNC software. 

It is an error if: 

e the P number does not evaluate to an integer in the range 1 to 20. 


Set Coordinate System Data : G10 L2 


To set the coordinate values for the origin of a coordinate system, program 

G10 L2 P... X... Y... Z... A... B... C..., where the P number must evaluate to an integer in the 
range | to 6 (corresponding to G54 to G59) and all axis words are optional. The coordinates of 
the origin of the coordinate system specified by the P number are reset to the coordinate values 
given (in terms of the machine coordinate system). Only those coordinates for which an axis word 
is included on the line will be reset. 

It is an error if: 

e the P number does not evaluate to an integer in the range | to 6. 

Example: G10 L2 P1 x 3.5 y 17.2 sets the origin of the first coordinate system (the one selected 
by G54) to a point where X is 3.5 and Y is 17.2 (in machine coordinates). The Z coordinate of the 
origin (and the coordinates for any rotational axes) are whatever those coordinates of the origin 
were before the line was executed. 


Plane selection : G17, G18, G19 


To select the XY plane program G17. 
To select the XZ plane program G18. 
To select the YZ plane program G19. 


Arcs will be interpolated on the selected plane. For more informations please read the description 
about G2, G3 in this documentation. 


Run to home position : G28 


To move the machine to the set home coordinates , program G28 X... Y... Z... A... B... C..., 

where the parameters are the axis coordinates of an intermediate point. 

When executing the G28 code and if any intermediate coordinates are programmed then the 
machine will first make a move to this point with rapid linear interpolation (G0) and from this point 
it will move to the set home coordinates again with GO interpolation. 

If intermediate coordinates are not programmed then the machine moves straight to the home 
position. 


Warning: Only execute a G28 when the machine is homed. 
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Home axis: G28.1 


To home the machine, program G28.1 , this will do the same as pressing the Home all button on the 
user interface. 


Straight Probe : G31 


Program G31 X... Y... Z... A... B... C...to perform a straight probe operation. 
Currently programming one axis word one time is allowed only. 


In response to this command, the machine moves the controlled point (which should be at the end 
of the probe tip) in a straight line at the current feed rate toward the programmed point. If the 

probe trips, the axis stops. If the probe does not trip even after reaching the programmed coordinate, 
the axis stops and the probing action ends. 

The probing command can be practically combined with other macro scripts, an example code is the 
M31 macro code which code can be find in the Macros library. 


Spindle Syncronised motion : G33 


Program G33 X... Z... K... Q... to perform a spindle syncronised motion, where the X parameter is 
the final position of the X-axis, the Z parameter is the final position of the Z-axis. The K parameter 
is the pitch per revolution and the Q parameter is the start angle in degrees. 


For the spindle syncronised motion an incremental encoder with A, B and Index channels has to be 
installed onto the spindle and the spindle encoder has to be setup in the software. 


When executing a G33 command, the motion controller will first waiting for the index channel 
signal from the spindle encoder and will syncronise the feedrate to the rotational speed. 

The start angle (Q parameter) defines the angle between the encoder index signal and the motion 
controller measures the set angle after the index signal and starts the motion at this angle. 

The G33 motion is always on a straight line just like with G1, but it is always on the XZ plane and 
the feedrate is continously syncronised to the spindle speed and taking the pitch (K) parameter into 
account. The syncronised motion always ends at the programmed X and Z coordinates. 

If both the X and Z coordinates are programmed for the G33 command and if both coordinates 
differs from the starting coordinates then the thread will be cut on a cone on the XZ plane and the 
thread will then not be parallel to the Z not the X axis. The pitch is then calculated on axis which 
makes the longer movement. 

If more G33 commands follows eachother and if the start angle is not programmed or only 
programmed for the first G33 command then the rest G33 commands will be syncronised with the 
previous G33 command which makes it possible to cut a continous thread even with changing pitch. 


Rigit tapping G33.1 and G33.2 


To execute a right hand (Leads in with M3) rigid tapping cycle program G33.1 Z... K... and to 
program a left hand (Leads in with M4) rigid tapping cycle program G33.2 Z... K..., where the Z 
parameter is the bottom of the tap along the Z-axis and the K is the thread pitch per revolution. 


The difference between the G33.1 and G33.2 is the direction of the thread, the G33.1 starts the 
tapping with CW rotation of the spindle, with M3 command in action when the tool is leading into 
the material and leads out with an M4 command. The G33.2 command starts the tapping with an 
M4 command when the tool is leading into the material and leads out with an M3 command. 

Prior to a rigid tapping cycle the tool on the XY plane should be moved to above the drilled hole 
which needs to be tapped and the M3 or M4 comamnd must be active. (depending on which code 
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was executed.) 
A rigid tapping command executes the following cycle: 


1.) The motion controller waits for the index signal of the spindle encoder and measures the 
rotational speed of the spindle and syncronises the Z-axis feedrate to the spindle speed with 
taking the thread pitch (K) parameter into account. The spindle should be already rotating to 
the correct direction, otherwise the tapping will not start and the software will wait for the 
spindle to turn. 

2.) The Z-axis motion starts and the tool is moved down to the programmed Z position. 

3.) At the bottom of the tap, at the programmed Z position the spindle direction is switched. 

If it is a G33.1 command then the M3 is switched to M4, or if it is a G33.2 command then 
the M4 command will switch to M3. This will reverse the spindle rotational direction. The 
syncron between the spindle and the Z-axis feedrate is kept. 

4.) The tool is moved out from the material to the starting point where the motion controller 
removes the syncron between the spindle and the Z-axis feedrate. 

The Z-axis stops using the set decceleration. This means that the axis will overrun the start 
point a bit, because it needs to travel a distance to deccelerate from the current feedrate. 

5.) The Z-axis is moved down to the start point with a rapid movement. 


Tool Length Offsets : G43, G44 and G49 


To use a tool length offset, program G43 H..., where the H number is the desired index in the tool 
table. The H number should be, but does not have to be, the same as the slot number of the tool 
currently in the spindle. It is OK for the H number to be zero, an offset value of zero will be used. 

It is an error if: 

e the H number is not an integer, is negative, or is larger than the number of carousel slots, which is 
currently set to a value of 20. 

The G44 command is similar to the G43, but for negative tool length offsets. 

To cancel the tool length offset compensation, program G49. 

It is OK to program using the same offset already in use. It is also OK to program using no tool 
length offset if none is currently being used. 


Temporary offset coordinate system : G52 

To offset the current point by a given positive or negative distance (without motion), program 

G52 X... Y... Z... A... B... C..., where the axis words contain the offsets you want to provide. All axis 
words are optional, except that at least one must be used. If an axis word is not used for a given 
axis, the coordinate on that axis of the current point is not changed. 


It is an error if all axis words are omitted. 


When G52 is executed, the origin of the currently active coordinate system moves by the coordinate 
values given. 


The effect of G52 is cancelled by programming: G52 X0 Y0 etc. 
The axis offsets are always specified in absolute values and effects all fixture coordinate systems. 
Move in Machine Coordinates : G53 


For linear motion to a point expressed in machine coordinates, program G1 G53 X... Y... Z... 
A... B... C... (or use GO instead of G1), where all the axis words are optional, except that at least 
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one must be used. The GO or G1 is optional if it is the current motion mode. G53 is not modal and 
must be programmed on each line on which it is intended to be active. This will produce 
coordinated linear motion to the programmed point. If G1 is active, the speed of motion is the 
current feed rate (or slower if the machine will not go that fast). If GO is active, the speed of 
motion is the current traverse rate (or slower if the machine will not go that fast). 

It is an error if: 

e G53 is used without GO or G1 being active. 


Select Coordinate System : G54 to G59 


To select coordinate system 1, program G54, and similarly for other coordinate systems. The 
system number G-code pairs are: (1—G54), (2—GS5), (3 G56), (4 G57), (5—G58), (6—GS59) 


Set Path Control Mode : G61, G61.1 and G64 
Program G61 or G61.1 to put the machining center into exact stop mode, or G64 for constant 
velocity mode. It is OK to program the mode that is already active. 


Peck drilling cycle with set backoff distance: G73 


To execute a peck drilling cycle with a set back off distance, program G73 X... Y... Z... Q... R., 
where the X, Y and the R parameters are optional and the Q parameter is modal. 

The peck drilling cycle rapids to the XY coordinates and then to the R plane where it begins to feed 
down in increments of Q at a feed rate of F to a depth of Z. At the end of each Q increment the drill 
will stop and back off the distance set on the General configuration screen's G73 back off label 
value to break a possible stringer chip and then continue with he next increment of Q. As in all 
pecking cycles the programmer does not need to calculate the number of pecks and peck distance 
that will equal the exact Z Depth. The controller will calculate the distance of the last peck to 
coincide with the Z depth. At the end of the cycle the Z axis returns to the R plane if the R 
parameter was set or to the initial plane if the R parameter was not set. 


Threading cycle: G76 


To execute a threading cycle, program G76 P... Z... I... J... K... E... L... Q... H... , where the 
parameters are the following: 


P: The pitch of the thread in distance units per spindle revolution. 

Z: The final position of the thread along the Z-axis. 

I: The thread peak position in units along the X-axis. This is the starting height of the thread and 
the material was mostly turned down to this size. 

J: Cut depth per pass. The first cut will be J beyond I along the X-axis. 

K: Full thread depth. The last cut will be this deep along the X-axis. 

E: Taper length. Specifies the length of the taper(s). For a 45° taper program the E parameter equal 
to the K parameter. 

L: Tapered ends. Specifies which end of the workpiece will get a taper. LO means no taper, L1 
means start taper, L2 means end taper, L3 means both start and end tapers. 

Q: Slide in angle. Specifies an angle between the cuts. As the tool goes from one cut depth to the 
other the cut start is offset along the Z-axis with this angle measured from the X-axis. Programming 
a positive or negative angle will make one or the other side of the tool to remove more material. 

H: Number of final cuts. To make any extra cuts on the final depth program this parameter other 
than 0. The value of the parameter will define the number of extra cuts on the final depth. If the 
parameter is not set the default value of 0 will be used causing a single final depth cut. 


For the thread cutting cycle first move the tool to the starting point and then program the G76 with 
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the required parameters. Executing the thread cutting code the tool will move to the thread peak 
position (I parameter) along the X axis in case no start taper is programmed. If a start taper is 
programmed then the tool will first move to the thread peak position minus the full thread depth. 
The motion controller will wait for the index signal input and will syncronise the axis feedrates to 
the spindle encoder. The thread cutting will start on the index signal and the feedrate is continously 
syncronised to the spindle speed. If a start taper was programmed then the tool cuts the taper first 
and this motion is also syncronised to the spindle. 

The thread cutting ends on the exact programmed Z position if no slide in angle was programmed 
(Q parameter) or if a slide in angle was programmed then the final Z position will be compensated 
with the slide in angle which can be in positive or negative direction depending on the sign of the Q 
parameter. 

If an end taper was programmed then the tool will slide out from the material also in syncron 
making a taper to the end of the thread. The end taper angle will be the same as the start tapper 
angle, in other words the start and the end tappers will be symmetrical. 

At the end of each thread cutting cycle the tool rapids out to the starting X coordinate first leaving 
the material and then to the start Z coordinate and begins a new cut cycle with a new cut depth. 

The process continues until the final thread depth is reached and if the H parameter is set other then 
zero then the final cut depth cycle is repeated H times. 


Cancel canned cycle: G80 


To cancel the drilling cycle program G80. The command cancels the drilling cycle and the last 
programmed G0, G1, G2 or G3 modal motion mode gets enabled. 


Drilling cycle: G81 


To execute a drilling cycle program G81 X... Y... Z... R..., where the X and Y parameters are the 
coordinates of the drill on the XY plane, the Z parameter is the endpoint of the drill along the Z-axis 
and the R parameter is the retract plane. 

The G81 code moves the tool to the XY coordinates with a single rapid movement where it starts 
moving down to the programmed Z coordinate along the Z-axis with the set feedrate. 

When the Z endpoint gets reached the Z axis reverses and rapids out of the drill to the retract plane. 


Drilling cycle with dwell: G82 


To execute a drilling cycle with dwell program G82 X... Y... Z... R..., P... where the X and Y 
parameters are the coordinates of the drill on the XY plane, the Z parameter is the endpoint of the 
drill along the Z-axis, the R parameter is the retract plane and the P parameter is a dwell time in 
milliseconds. 

The G82 is very similar to the G81 code, the only difference is that the software dwells at the 
bottom of the drill before it rapids the tool out. 


Peck drilling cycle with full backoff distance: G83 


To execute a pecl drilling cycle with a full back off distance, program G83 X... Y... Z... Q... R., 
where the X, Y and the R parameters are optional and the Q parameter is modal. 

The G83 code is very similar to the G73, the only difference is that at each peck increments the 
controller returns to the R plane if the R plane was programmed or to the initial plane if the R 
parameter was not set. The purpose of this command is the same as of the G73, but because of the 
full retract at each increments can break spiral chips better. 
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Absolute distance mode selection: G90 


To select absolute distance mode program G90. This will make coordinates in the executed 
commands to be interpreted as absolute position values. 
The G90 command can be executed any time in code execution or via the MDI. 


Relative distance mode selection: G91 


To select relative distance mode program G91. This will make the coordinates in the execured 
commands to be interpreted as relative position values to the actual coordinates. 
The G91 command can be executed any time in code execution or via the MDI. 


Temporary offset to programmed coordinates : G92 


To make the current point have the coordinates you want (without motion), program 

G92 X... Y... Z... A... B... C..., where the axis words contain the axis numbers you want. All axis 
words are optional, except that at least one must be used. If an axis word is not used for a given 
axis, the coordinate on that axis of the current point is not changed. 


It is an error if all axis words are omitted. 


When G92 is executed, the origin of the currently active coordinate system moves. To do this, 
origin offsets are calculated so that the coordinates of the current point with respect to the moved 
origin are as specified on the line containing the G92. The offset for an axis is the amount the origin 
must be moved so that the coordinate of the controlled point on the axis has the specified value. 


The axis offsets are always specified in absolute values and effects all fixture coordinate systems. 


Because the G92 offset is temporary, unlike the other offsets the G92 offset coordinates are not 
saved when closing the software. The G92 offset coordinates are always 0 on software startup. 


Reset temporary offset coordinates : G92.1 


To reset the G92 offset coordinatets program G92.1. 


5.1.2 .M-codes 


Macro codes can be called from code execution or via the MDI control. To program a macro call 
Mx, where 'x' means a positive integer number and this number is the number of the macro to call. 
Macros are text files and located in the folder of the machine profile. 


There are default macros in the RS274 language and there are some other macros which we 
prepared as an example. These macros and their functions are described in this section of the 
documentation. 


Macros can have upto 3 parameters programable with the 'E', 'H' and 'Q' prefixes. 

For example 'M300 E1.2 H3 Q4.5'. 

The parameters are all optional and if a parameter is set it can be used inside the macro with the 
Evar, Hvar and Qvar variables. These variables are always defined and set when the macro is called. 
The default value of all these parameters are 'null', if the parameters does not exist when called then 
the parameters will have a 'null' value. 


The following are the default macros built into the UCCNC: 
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Program stop: M0, M1, M60 

Program MO, M1 or M60 to stop the g-code program execution. The code execution can be 
continued with a new cycle start operation. 

The MO, M1 and M60 codes function the same, but they activate different virtual LEDs so the user 
and plugins and macros can distinguish which code was activated. 


Program end: M2 
Program M2 to end the g-code program. 
The M2 macro can be programmed in code execution only, in MDI it has no meaning. 


Turn spindle clockwise: M3 
Program M3 to start the spindle rotation in the clockwise direction. 
The M3 macro can be programmed in code execution and via the MDI. 


Turn spindle counterclockwise: M4 
Program M4 to start the spindle rotation in the counterclockwise direction. 
The M4 macro can be programmed in code execution and via the MDI. 


Stop spindle turning: M5 
Program M5 to stop the spindle rotation. 
The M5 macro can be programmed in code execution and via the MDI. 


Tool change: M6 

To change a tool in the spindle from the tool currently in the spindle to the tool most recently 
selected, program M6 which will call the M6 macro. The number of the tool to select can be 
programmed with the "T" keyword. 

We supplied an example tool change M6 macro in the macro library of the Default profile. 

Example usage: M6 T2 , will change the current tool to tool number 2. 

The M6 macro calls can be overridden in the setup on the general settings tab page! 


Coolant Control: M7, M8, M9 

To turn mist coolant on, program M7. 

To turn flood coolant on, program M8. 

To turn all coolant off, program M9. 

It is always OK to use any of these commands, regardless of what coolant is on or off. 


Activate syncronous fast (laser) output: M10 

To activate an output in syncron with the motion program M10 Q..., where the Q parameter is the 
duty cycle of the PWM output pin and the range is 0..255 for the 0 to 100% duty cycles. If the Q 
keyword is omitted then the maximum 255 value is used. The output port and pin number can be 
selected on the Configuration/I/O setup tab page. The output will be a PWM and the duty cycle of 
this signal will be set by the programmed Q parameter. 

The M10 command can be used to control a laser device or any other device which requires fast and 
syncronous switching with the motion. 


Deactivate syncronous fast (laser) output: M11 

To activate an output in syncron with the motion program M11 

Executing this macro will switch off the fast syncronous laser output if it was previously switched 
on with an M10 Q... command. 


Stop program and reqind code: M30 
To stop the program and rewind the code to the first line, program M30. 
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Usually the M30 is placed at the very end of the G-code program. 


Program rewind and continue running: M47 
To rewind the program and continue code execution from the first line, program M47. 
Usually the M47 is placed at the very end of the G-code program. 


Subroutine call: M98 

To call a subroutine program: M98 P... L..., where the P parameter defines the number of the 
subroutine to call and the L number defines the number of times the subroutine needs to be called. 
If the L parameter is not programmed then the default L value of 1 is used. 

It is an error if the P parameter is not programmed. 

A subroutine call can be placed inside another subroutine. The subroutine stack is 100 level deep. 

If a subroutine call is deeper than the subroutine stack size then the stack will get full and a popup 
window will indicate this error and the code execution will be stopped. The stack full error is likely 
to happen if a subroutine is called from itself which will create an infinate loop and stack overflow. 


Return from subroutine: M99 

To return from a subroutine program M99. 

This will return the line pointer to the code line the call was made. 

It is an error if the M99 code was called without an M98 code was called, in this case the code 
interpreter will not know where to return the code line pointer and a popup window will indicate 
this error and the code execution will stop. 


Enable THC control for plasma: M205 

To enable the THC control for a plasam cutter machine program M205. 

The THC control will use the THC up and THC down and THC on signals to control the Z-axis 
position. 


Disable THC control for plasma: M206 
To enable the THC control for a plasma cutter machine program M206. 


Constructor macro: M99998 
This macro is called on each software startup. Initial actions like user variables loading and startup 
settings could be made using and programming this macro. 


Destructor macro: M99999 
This macro is called on each software shutdown. User variables and DRO values could be saved or 
messages could be shown to the user etc. on the software shutdown with programming this macro. 


5.1.3 .Other codes 


Set Feed Rate: F 

Program F... to set the feedrate. 

Note that the Feedrate can be override in the 1-300% range using the + and — buttons in the feedrate 
override DRO. 


Set Spindle Speed: S 

To set the speed in revolutions per minute (rpm) of the spindle, program S... . The spindle will 
turn at that speed when it has been programmed to start turning. It is OK to program an S word 
whether the spindle is turning or not. If the speed override switch is enabled and not set at 100%, 
the speed will be different from what is programmed. It is OK to program SO; the spindle will not 
turn if that is done. It is an error if: 
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e the S number is negative. 


Note that the Spindle speed can be override in the 1-300% range using the + and — buttons in the 
spindle speed override DRO. 


Subroutines: O 
The subroutines are labeled with the 'O' prefix. 
Usually the subroutines are placed at the end of the program, after the M30 or M47 code. 


Load tool: T 

To load a tool program T... , for example T2. 

Programming the T code loads the tool number into the next tool variable in memory and on the 
next M6 code programming the actual tool will be changed to the most recently programmed tool 
number. 


5.2 .Parametric programming 


Instead of constants variables could be also used to define coordinates or feedrate, spindle speed 
etc. There are 1000 pieces of variables internal variables currently, named as #0 to #999. 

When a number is programmed with the '#' suffix means that this paramater is not a constant, but a 
pointer to an internal variable. 

The variables can get new value any time programming an equation in code execution or via MDI. 
Mathematic equations can be also programmed to give value to variables. 

For example to give a value of 1.23 to variable #2, code: '#2 = 1.23'. 

Equations should always be in a new line, it is not allowed to place an equation as a parameter of an 
axis word or feedrate or spindle speed set code. A single variable can be programmed as a parameter 
standalone only. 

The following code example shows how to use the variables: 


#1 = 5 (Sets the value of variable #1 to 5) 

#2 = 10 (Sets the value of variable #2 to 10) 

GO X#1 Y#2 Z1 (Moves the axis with rapid to coordinates X=5, Y=10, Z=1) 

#2 = 1.5 (Sets the value of variable #2 to 1.5) 

G1 X#1 Y#2 Z#2 (Moves the axis with set feedrate to coordinates X=5, Y=1.5, Z=1.5) 
#3 = #1 + #2 (Sets the value of variable #3 to 6.5) 

#4 = 100 (Sets the value of variable #4 to 100) 

G1 X#3 F#4 (Moves the axis with set feedrate of 100 unit/min to coordinates X=6.5) 


To program complex equations it is often required to use brakets. Because in the RS274NGC 
programming the round brackets '(' and ')' are used to defined comments for the equations the 
rectangular brackets '[' and ']' should be used. Also to define a comma for functions which has more 
than one parameters use the ';' character instead of the ',' comma. 

For example: #1= [1 + #2]*3 


And there are two available built in constant variables, these are the 'pi' and the 'e'. 
5.2.1 .Available math operators and operations 
In the equations the constants and internal variables can be mixed with mathematical operators and 


functions to calculate complex equations inline. The mathematic operators and the supported 
functions are listed below: 
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Operator | Name of function Short description 
+ summation Summarise numbers. 
- deduction Deduct numbers. 
a multiplication Multiply numbers. 
/ division Divide numbers. 
% division for remainder | Returns the remainder of a division. 
A power Returns a specified number raised to the specified power. 
? Get variable value | Shows variables value in a window. 
For example ?#1 prints the value of #1 variable. 
Note: This operator works in MDI input only. 
abs absolute value Returns the absolute value of a number. 
acos arc cosine Returns the angle whose cosine is the specified number. 
asin arc sine Returns the angle whose sine is the specified number. 
atan arc tangent Returns the angle whose tangent is the specified number. 
cosh hiperbolic cosine | Returns the hyperbolic cosine of the specified angle. 
exp exponentiation Returns e (the base of natural logarithms) raised to the 
specified power. 
floor floor Returns the largest integer that's less than or equal to the 
specified number. 
log logarithm Returns the natural (base e) logarithm of a specified number or 
the logarithm of a specified number in a specified base. 
log10 10 base logarithm _| Returns the base 10 logarithm of a specified number. 
min minimum Returns the smaller of two numbers. 
Example: min[1;2] gives an output of 1. 
max maximum Returns the larger of two numbers. 
Example: max[1;2] gives an output of 2. 
pow power Returns a specified number raised to the specified power. 
Exampe: pow[2;3] gives an output of 8. 
rnd round to 0 to 9 Rounds the input number to 0 to 9 decimal places. 
decimals Exampe: rnd[1.234;2] gives an output of 1.23. 
sin sine Returns the sine of the specified angle. 
sinh hyperbolic sine Returns the hyperbolic sine of the specified angle. 
sqrt square root Returns the square root of a specified number. 
tan tangent Returns the tangent of the specified angle. 
tanh hyperbolic tangent | Returns the hyperbolic tangent of the specified angle. 





5.3 .Using the software, executing codes, using functions 
5.3.1 .Open, edit, close a G-code file 


G-codes files are codes generated with a CAM software or simply written by hand using a notepad. 
These code files must have a format defined in the RS274 standard and also detailed in this user's 
guide. The UCCNC software can open, read and execute these files files. 
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To open a G-code program press the load file button in the software, this action will start a standard 
open-file dialog where the file can be selected and opened. When opening the file the G-code 
interpreter checks the file through, interpret the code written inside and places it into the G-code 
viewer control. Also the path for the file is calculated and showed in the Toolpath viewer control. 


To rewind the file to the beginning (first line) press the rewind file button. To close the file press the 
close file button. Closing the file will unload the file from the G-code viewer and the Toolpath 
viewer and also the file will and the associated variables and structure will be unloaded from the 
computer's memory. 


The file can be also edited to do that press the edit file button, this will open the file in notepad.exe 
software which is built into the Windows Operating System. When the file editing is finished 
simply close the file and the UCCNC software will automaticaly reload the file. 


5.3.2 .Executing code from program 


To execute, stop a program use the buttons on the right side of the screen. These buttons are visible 
on all tab pages. To start a Cycle press the "Cycle Start" button. The virtual LED on the bottom 
right corner of the button will light while the cycle is running. When the program execution ends 
the virtual LED goes off. 

To run a single line of code only press the "Single Cycle" button, this will execute a single line of 
code only. The virtual LED in the bottom right corner of the button will light while the cycle is 
running and the LED goes off as soon as the execution of the line finishes. 

When a Cycle or a Single line is being executed press the "Stop Cycle" button any time to stop the 
Cycle. When pressing the "Stop Cycle" button the Cycle is stopped which stops the motion with 
decceleration in case any axis was moving. The decceleration of the axis happens with using the 
acceleration values set for the axis. 

To stop the Cycle and movement immediately without a decceleration press the "Reset button". This 
will stop the Cycle and the motion without decceleration, immediately. The "Reset button" is a 
toggle type of button, it blinks if pressed in and this blinking means that the machine is in reset and 
it cannot be moved, no motion can be executed. Pressing the "Reset button" again brings the 
machine out of reset. 


The software can be put to Offline mode with pressing the "Offline" button. In offline mode all 
outputs of the UC100 device goes to the default output state and no output signals are generated. 
The software in the offline state operates as if it was just simulating the motions and the functions. 
The offline mode can be used for example to run a G-code software without the machine moving 
and check what the machine will do prior the real machining cycle. 


5.3.3 .Executing code via the MDI 


The MDI (Manual Data Input) control provides the ability to execute a G-code command without 
loading a G-code program. The MDI is an input field where a text can be entered and after typing 
the text command pressing the enter will make the software interpret the entered text and execute 
the command. The textfield of the MDI control will blink green color if the input text is 
understandable and executable by the interpreter and it will blink red color if the text is not 
interpretable. After a red clor blinking no action will be taken by the software. After a green blink 
the software will execute the command which was entered. 


The right side of the MDI control shows the active motion mode of the MDI. The active motion 


modes can be GO, G1, G2 or G3. When any of these modes are active inputting only axis woords 
with coordinates is valid. For example if the GO is the active motion mode then a 'X1 Y2' text typed 
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into the MDI will move the axis with a rapid linear movement from the current coordinates to the 
X=1 and Y=2 coordinates. 
The following printscreen picture shows text input in the MDI control: 
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5.3.4 .Zeroing and referencing one or more axis 


All of the 6-axis can be zerod and referenced (homed) using the axis zero and home buttons. 
Axis can be homed and referenced individualy or all pressing a single button. When all axis are 
referenced, the homing is done in sequence. The following picture shows the ref and home buttons: 
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5.3.5 .Using offsets 


Offsets are used to define different origin coordinate system inside and derived from the machine 
coordinate system. The machine coordinate system origin point is defined by the reference (home) 
points. The offset coordinate system are offset from the machine coordinates by the user defined 
lengths. Different work offset values can be defined for each axis and for the Z-axis also a Tool 
length offset can be defined which offset is useful when compensating the drilling or milling tool's 
length in the machine's chuck. There are in total 6 pieces of offset coordinate systems, these are 
named G54 to G59. The different coordinate systems can be selected using the on screen offset 
buttons or programming the G54 to G59 codes in program or via the MDI. 

When selecting a coordinate system the screen set offsets are applied to the system and the 
coordinate DROs' values are compensated with the offset values. 

The Offset coordinates can be edited on the Offsets tab page. 

The following picture shows the Offsets tab page: 
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X 60.0000 = 72.5000 - 12.5000 - 0.0000 

Y 0.0000 =| 223.5650 |=| 223.5650 |= 0.0000 

Z 0.0000 =| -36.7600 -| -36.7600 |- 0.0000 = 0.0000 SINGLE 
A 0.0000 = 0.0000 = 0.0000 = 0.0000 aie 
B 0.0000 = 0.0000 = 0.0000 = 0.0000 FEED 
C 0.0000 = 0.0000 = 0.0000 = 0.0000 





Active fixture: G54 





5.3.6 .Overriding the feedrate and the spindle speed 


The programmed feedrate and spindle speed can be overridden any time, even when a code is 
executed and when a motion is in progress. Both properties can be overridden in the range of 0- 
300% of the programmed value. The override feature is useful for example if the programmed 
feedrate is too slow or too fast and need to be adjusted, but the operator does not want to bother 
with regenerating the code with new feedrate values. The same is true for the spindle speed 
override, if the spindle speed is controlled from software then the programmed speed can be 
overriden on the fly which makes the system more comfortable for the operator and more 
productive saving lots of additional work and time. 

To override the feedrate use the + and — buttons next to the feedrate and the spindle speed DROs. 
Pressing the plus button increases the value with +10% if the value is equal or above 10% and it 
increases +1% if the actual value is below 10%. Pressing the minus button decreases the value with 
10% in case the current value is above 10% and decreases the value with 1% if the actual value is 
equal or below 10%. 

If the feedrate override is set to 0% then the motion stops and stalls till the DRO value is changed to 
any higher value. 


The following picture shows the Feedrate override and the Spindle speed override interfaces: 
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5.3.7 .Using the toolpath and G-code viewers. 


The toolpath viewer is a 3D openGL control which shows the actually loaded toolpath. The toolpath 
drawing in the toolpath window can be rotated, panned, zoomed and moved using the mouse 
pointer and mouse buttons. 

There are also buttons next to the window to apply different viewpoints to the window. 
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5.3.8 Jog control, jogging the machine 


The jog controller is used to move the machine manually with pressing screen buttons. Also the 
manual pulse generator and the associated buttons can be found on this screen. 

The jog panel is located on the very left side of the screen and on startup this screen is hidden, only 
it's right side border is shown. Touching the panel's border with the mouse pointer makes the jog 
pannel to pop and apper on the screen. The panel is not available when a motion is in progress, 
when the machine controller is busy executing commands. 

There are + and — jog buttons on the jog panel, pressing these buttons all axis can be jogged to the 
negative and to the positive directions. The Jog feed sets the feedrate of the jog movements, the 
value is defined in percentage of the set maximum (G0) feedrate of the axis. 

The mode of the jogging can be selected with buttons on the screen, there are continous and 
stepping modes and also there is an MPG mode. 

In continous jogging mode the machine axis jogs while the jog button of the axis is being pressed 
and the jog finishes when the button gets released. 

In step jogging mode the axis moves the selected distance for every jog button presses. Currently 
there are 0.01, 0.1 and 1 unit lengths are selectable. 

In MPG mode the external MPG device is selected for the jogging and selecting this mode disables 
the screen buttons jogging. The MPG mode has 3 running modes, the MPG cont., the MPG single 
and the MPG multi modes. 

In the MPG cont. mode when rotating the MPG wheel the axis continously moving with the wheel 
rotation. 

In MPG single mode when rotating the MPG wheel the axis is moving the jog step distance on the 
first encoder tick, the distance is selected with the distance buttons 0.001, 0.01, 0.1 or 1.00 Units. 
The next movement happens after the motion is finished and on the next encoder tick. 

In MPG multi mode when rotating the MPG wheel the axis is moving the jog step distance on all 
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encoder ticks, the distance is selected with the distance buttons 0.001, 0.01, 0.1 or 1.00 Units. 

The axis to move with the MPG can be selected with the X,Y,Z,A,B,C buttons. 

Also there are button codes for the MPG axis selection, so external buttons or switches on the MPG 
controller can be connected to the UC100 or UC300 inputs and they can be configured to these axis 
selection button codes, these settings can be made on the input trigger configuration page. 

The associated buttons codes are documented in the buttons by number.htm document in the 
documentation section of the UCCNC installation. 

The following screen shows the jog panel on the left side of the UCCNC software window: 
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6 .Macro-ing capability. 


The macro codes are text files located in the Profiles\Macro Name of profile\ folder, where the 
"Name of profile" is the profile name the machine is running. A macro can contain simple or even 
complex code to execute even a bunch of movements and I/O manipulations. 

A macro can be called from program execution or via the MDI control with simply programming 
Mx, where the "x" means an integer number. When calling a macro the corresponding macro file is 
read, compiled and executed by the interpreter. If the macro file contains a syntax error then the 
macro is ignored and skipped and an error message is shown in the status list control. 


There are default macros in the RS274 programming language, but also custom macros can be 
written by the user with creating the required macro file in the profile's macro folder and writing the 
script into the file using notepad.exe forexample. 


Macros can be edited using a text editor like notepad. The macro files can be edited on the fly, 


because the macro scripts are read and compiled on runtime, when the macro is called. 
For informations about writing custom macro codes please read the 
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Macroing capability detailed.pdf document. 
7 Plugin control modules 


Plugin controls are software modules which builds into and works within and together with the 
UCCNC software. 

The following picture shows the plugin configuration window which window can be opened with 
pressing the Configure plugins button on the Configuration/General settings tab page. 
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7.1 Installing plugins 


To install new plugins simply copy the plugin .dll file to the /Plugins subfolder in the UCCNC 
installation folder. The software will automatically detect the new plugin on the next software 
startup. By default the a newly installed plugins are disabled, in order to make them run they have 
to be enabled on the Plugin configuration window. 


7.2 .Enabling, configuring and using plugins 


Every plugin can be configured using the Plugin configuration window. The plugin properties are 
shown in this windows. Every row on this windows lists one plugin and the first text section of this 
row shows the name, the version number of the plugin and the name of the author. The plugins can 
be opened up with pressing the Show button in the row of the plugin. Pressing the Show button 
calls the Showup event of the plugin if the actual plugin has this interface implemented. In most 
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cases this event opens and shows a Window which represents the plugin. If the plugin does not 
implement the Showup event then the UCCNC software will show an error message with a message 
about this. Some plugins which just running in the background may not need a visual interface and 
may not implement the Showup event. 


To configure a plugin press the Configure button in the row of the plugin, this will call the 
Configuration event of the plugin. Usually this event will popup a new window where the user can 
set parameters about the plugin. If the plugin does not implement the Configuration interface then 
the software will show an error message about this. Some plugins may not need a configuration UI, 
because there is nothing to configure in them or the plugin writter decided to place all configuration 
settings on the main window of the plugin which can be called with the Show button as described 
previously. 


The plugins can be individually enabled with checking the enable checkbox of the plugin. If a 
plugin is enabled then it will start running when the UCCNC software starts up and when it has 
finished all of the initialisation process. If the plugin is disabled then the UCCNC will not call the 
create the plugin oject and also no other messages will be sent to the disabled plugin, in other words 
the plugin will be not running. 


If checking the call startup checkbox of the plugin then the plugin's startup event will be called on 
the UCCNC startup. Itmust be noted that the plugin mist be enabled for the startup function to be 
called. The startup event mostly contains code which opens the plugin Window, but how it is 
implemented depends on the plugin's developer. Plugins which has no visual appearance just 
running in the background may not show any windows on the software startup, but may still do 
things in the background when this event is called. How and for what the plugins can be used for 
depends on the purpose of the plugin. Plugins can implement different and even complex features 
which features may be useful for some users with different machine setups and different needs for 
different functions. 


An example plugin is the laser engraving plugin. With the use of this plugin scan type laser 
engraving can be done with the UCCNC software. The plugin can read picture images and converts 
it to grayscale or black and white image and then to vectors and executable code for the UCCNC. 
The following picture shows the laser engraving plugin: 
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7.3 .Writing/creating custom plugins 


The plugin interface allows programmers to create their own plugin modules for the UCCNC 
software. A plugin modul is a .dll (dynamic link library) file which is placed into the UCCNC 
installation directory and which software module can then communicate and interact with the 
UCCNC software. To write a plugin the plugininterface.dll file (located in the UCCNC directory) 
should be included into the plugin project. The plugin interface is a NET 2.0 based code and so the 
plugin has to be also .Net 2.0 based. We advice to use Visual Studio to create new plugins. 


In the plugins folder there is an Example folder which contains the source code for an example 
plugin. This source code could be studied and may be modified for a new plugin creation. Since 
Visual Studio has intellisense the avilable function calls to the UCCNC can be easily explored and 
accessed via the plugin interface dynamic library. 


8 .Screen editor 


8.1 .Description of the screen editor 


The UCCNC software has a built in screen editor module. To enter the screen editing mode press 
the Edit screen button on the Configuration/General settings tab page. 


Entering the screen editor mode any of the screen elements like the buttons, textfields, labels, tab 
pages, backgrounds, LEDs, etc. can be resized, replaced, removed or any type and number of new 
elements can be added to the screen. 


In screen editor mode all functions of the UCCNC are disabled/inactive, pressing buttons will take 
no effect. To use the software functions again the screen editor mode must be left, this can be done 
with closing the screen editor window. 


61/67 


The following printscreen shows the screen editor window with the screen editor mode active: 
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8.2 .Editing screen elements 


When in screen editor mode pressing any screen items will select the item. The selection will be 
indicated with a blinking red border around the selected item. 


After selecting an item the property grid control on the Selection tab page of the screen editor 
window will list the properties of the item. The properties can be changed with overwritting the 
values in the property grid control. To validate the new values press the Apply settings on the 
bottom of the tab page. After validating the new values the changes will immediately take effect and 
the item will change position or size etc. depending on which properties where changed. 


The screen items can be also dragged and resized using the mouse. After the item was clicked and 
selected clicking the item again with holding the mouse button down and moving the mouse will 
drag the item. When releasing the mouse button the item's new position will be registered and 
shown in the property grid. To resize an item move the mouse on the blinking selection border and 
when the cursor changes to the resize arrows then press the mouse button, hold it down and move 
the cursor to pull and resize the item. 


To undo the last change press the Undo button. The Undo button will only reverse the last change 
and only while the item is still selected. 


To change between tab screens while in screen editor mode press and hold the Shift keyboard key 
and click the tab page's header with the mouse. 


To edit the fills (hider panels) press the control keyboard key. Pressing the Control key will toggle 
the fill items' visibility when working in screen editing mode. When the fills are visible then they 
can be selected and edited just like the other screen items. 
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The following printscreen shows an example where the Feedhold button' is selected and it's position 
and dimensions were changed. 
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To add new items or to delete an existing one select the item with clicking on it and go to the 
Create/delete tab page. There are individual buttons to create different type of new objects. Pressing 
these buttons will create a blank new screen item of the selected type. 


To delete an item after selecting it click the Delete selection button. 
To copy an existing item select the item and press the Copy selection button. 


The new item will be created and shown on the middle of the screen. The new item will be blank, 
the properties of the new item can be filled afterwards. 


The following printscreen shows the Create/delete tab page of the screen editor window: 
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8.3 .Editing the canvas properties 


The resolution of the main screen sanvas can be set on the screen editor window on the Screen tab 
page. The screen resolution is defined in pixels. Changing the screen resolution can be useful when 
different monitors, aspect ratios are used. Different screensets can be designed to fit specific 
monitor resolutions. 


The coordinates of the screenset items will be relative to the set resolution. For example if the 
screen vertical resolution is 1000 pixels and a button's vertical position is at 500 pixels then the 
button’ left side will be shown on the middle of the vertical resolution. 


If the screen vertical resolution is changed to 2000 pixels and if the button will still have the 500 
vertical coordinate then it will appear at the first quarter of the screen. 


The vertical and horizontal resolutions of the jog screen can be set separately on the same tab page 
and in addition the tab size of the jog screen can be also defined. The tab size means the number of 
pixels which will remain visible from the jog screen at the left side of the window when the jog 
screen is in it's hidden state. 


The following printscreen shows a case when the main screen's horizontal and vertical resolutions 
ware both changed: 
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@ Screen editor 
Selection | Create/delete | Screen | Images | File R 
D 














Main screen X resoluion (pixels): 
1200 
Main screen Y resoluion (pixels): 
800 + 


Jog screen X resoluion (pixels): 
300 $ 


5H OH HO ® 


Jog screen Y resoluion (pixels): 
692 

Jog screen tab size (pixels): 

40 + 











Apply settings VER ATS 


> rofile:Default 





8.4 .Editing picture images 


Most of the screen items like the buttons, LEDs, tab screens, backgrounds rendering images. These 
images are defined in the screenset file. To edit the to be loaded images select the Images tab page 
on the screen editor window. This page lists all the to be loaded images names. All images in the list 
has 2 file references, because all buttons and LEDs etc. have an up and a down or on/off states. 
Separate images are used in these states of the screen items. To change the image reference click on 
the filename in the list, this will open an open file dialog and browse and select the new image file 
to be used. At the bottom of the page there are buttons to add new images or to delete an existing 
images from the list. Set the number of the new image in the numeric up/down counter control next 
to these buttons. Adding a new image will make a new entry in the image list. 
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The following printscreen shows the images list on the screenset editor window: 
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Con en cine E e lara Kernel frequency: 
Inte | Selection | Create/delete | Screen| Images |File | O 25kHz 
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138 UP: BMP/Defaultscreenset/CAM_ImportDXF_up.png 
138 DN: BMP/Defaultscreenset/CAM_ImportDXF_down.png 1 OOkH z 

139 UP: BMP/Defaultscreenset/CAM_generatetoolpath_up.pn¢ Positi on DROs di gits: 4 + 
139 DN: BMP/Defaultscreenset/CAM_generatetoolpath_down oa 

140 UP: GMFVDe laukscree selCAM icreateycode! sm png On tool change code (M6) do the following: 


140 DN: BMP/Defaultscreenset/CAM_creategcode_down.png Ignore tool change code (M6) 


141 UP: BMP/Defaultscreenset/CAM_sendcodetouccnc_up.pr 
141 DN: BMP/Defaultscreenset/CAM_sendcodetouccnc_dow 


142 UP: BMP/Defaultscreenset/feedhold_up.png A Run the tool change macro (M6) SINGLE 
LINE 


(O Stop spindle and wait for Cycle Start 


142 DN: BMP/Defaultscreenset/feedhold_down.png Safe Z height (Units) 25 


143 UP: BMP/Defaultscreenset/Configplugins_up.png F 
143 DN: BMP/Defaultscreenset/Configplugins_down.png G73 back off (Units) 0.4 





144 UP: BMP/Defaultscreenset/User_up.png (O Measure dwell in seconds instead of msec 
144 DN: BMP/Defaultscreenset/User_down.png 





145 UP: BMP/Defaultscreenset/background29.png 
145 DN: BMP/Defaultscreenset/background29.png 
146 UP: BMP/Defaultscreenset/editscreen_up.png ~ | 6.) |None ml 
146 DN: BMP/Defaultscreenset/editscreen_down.png 











0 + | Add new image | Delete image 




















8.5 .Saving the screen 


To save all changes to the screenset select the File tab page on the screen editor window and press 
the Save screenset button. To save the screenset to a different screenset file select the file with 
pressing the Set file button on the same page. 


The screens for different motion controller devices are defined in sections inside the screenset file. 
For example if a UC100 motion controller or the UC100 demo mode is loaded then saving the 
screenset will save the screenset datas to the UC100 section in the screenset file. The section start 
and section ends are marked in the file with the //region devicetype and //endregion devicetype, 
where the devicetype means the device name. When starting up the UCCNC the software will read 
the screenset datas for the used motion controller device with reading the datas only from between 
the region definition markers. In case a device has no screenset region defined in a screenset file 
then the software will remove all the other regions and will execute the remaining datas which are 
outside all of the region declarations, in most cases this will mean that the screen will be empty 
white. 
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The following printscreen shows the File tab page of the screen editor: 
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On tool change code (M6) do the following: 


ees aes Ignore tool change code (M6) 
( Stop spindle and wait for Cycle Start 


©) Run the tool change macro (M6) 


Safe Z height (Units) 25 
G73 back off (Units) 0.4 
[O Measure dwell in seconds instead of msec 


sequence: 
f 4.) [None 7| 5.) [None 7| 6.) None 




















67/67 


